95 lines
4.7 KiB
TeX
95 lines
4.7 KiB
TeX
\chapter{Kanban Setup}
|
|
\ChapterLabel{KanbanSetup}
|
|
\index{Kanban}
|
|
\index{Kanban!board configuration}
|
|
\index{Kanban!column policy}
|
|
\index{work in progress}
|
|
\index{GitHub Projects}
|
|
\index{flow}
|
|
|
|
\section{Purpose}
|
|
This chapter records how the Kanban board for this assignment was selected,
|
|
configured, and used. The board makes the work of producing this document
|
|
visible, bounds the amount of work in progress, and provides a single place
|
|
where the state of each deliverable can be checked. It covers the tasks of this
|
|
assignment only; a board for the semester project will be established separately
|
|
once teams are formalized.
|
|
|
|
\section{Tool Selection}
|
|
\index{Kanban!tool selection}
|
|
The board was created with \textbf{GitHub Projects}. GitHub was selected as the
|
|
platform of choice for familiarity and simplicity; the board and versioned document
|
|
live in the same account, and draft items can be created without opening a repository issue.
|
|
|
|
\section{Board Configuration}
|
|
\index{Kanban!setup steps}
|
|
The board was configured in the following order.
|
|
|
|
\begin{enumerate}[leftmargin=*]
|
|
\item Created a new project from the account-level Projects page and selected
|
|
the board layout, which provisions a \texttt{Status} field with the
|
|
columns \texttt{Todo}, \texttt{In progress}, and \texttt{Done}.
|
|
\item Replaced the default column descriptions with the explicit entry and exit
|
|
criteria recorded in Table~\ref{Table:ColumnPolicy}, so that the meaning
|
|
of each column is explicit.
|
|
\item Set a \gls{wip} limit of two items on the \texttt{In progress}
|
|
column.
|
|
\item Added one card per deliverable of this assignment, as listed in
|
|
Table~\ref{Table:CardInventory}, entering each as a draft item.
|
|
\item Assigned every card to its owner so that the board
|
|
is the record of who holds each task.
|
|
\item Moved cards across columns as the work was actually performed, rather than
|
|
reconstructing the board before submission.
|
|
\end{enumerate}
|
|
|
|
\section{Column Policy}
|
|
\index{Kanban!definition of done}
|
|
Each column states the condition a card must satisfy to enter it. The
|
|
\texttt{Done} condition is written so that it can be checked against the
|
|
compiled document rather than judged by opinion.
|
|
|
|
\begin{tabularx}{\linewidth}{L{2.6cm}Y}
|
|
\caption{Kanban Column Policy\label{Table:ColumnPolicy}}\\
|
|
\toprule \textbf{Column} & \textbf{Entry and exit criteria}\\ \midrule
|
|
\texttt{Todo} & Ready to be worked on.\\
|
|
\texttt{In progress} & Actively being worked on by its assignee. 2 in-progress cards max.\\
|
|
\texttt{Done} & Chapter compiles and is referenced in document history.\\
|
|
\bottomrule
|
|
\end{tabularx}
|
|
|
|
\section{Card Inventory}
|
|
\index{Kanban!card inventory}
|
|
The board carries one card per assignment deliverable. Identifiers follow the
|
|
activity convention used elsewhere in this document so that cards and document
|
|
content can be cross-referenced.
|
|
|
|
\begin{tabularx}{\linewidth}{L{1.8cm}L{4.4cm}L{2.2cm}Y}
|
|
\caption{Kanban Card Inventory\label{Table:CardInventory}}\\
|
|
\toprule \textbf{ID} & \textbf{Card} & \textbf{Column} & \textbf{Completion criterion}\\ \midrule
|
|
\endfirsthead
|
|
\multicolumn{4}{l}{\small\itshape Kanban Card Inventory (continued)}\\
|
|
\toprule \textbf{ID} & \textbf{Card} & \textbf{Column} & \textbf{Completion criterion}\\ \midrule
|
|
\endhead \bottomrule \endlastfoot
|
|
\ActivityID{ACT-01} & Compile Overleaf template & \texttt{Done} & The unmodified template builds in Overleaf with no unresolved references and a populated glossary and index.\\
|
|
\ActivityID{ACT-02} & Create Kanban Setup chapter & \texttt{In progress} & This chapter compiles into the document and describes the board's configuration and use.\\
|
|
\ActivityID{ACT-03} & Define Hosts chapter; define hosts & \texttt{Todo} & The chapter compiles and contains the planned host table.\\
|
|
\ActivityID{ACT-04} & Create Passwords chapter; create password rule & \texttt{Todo} & The chapter compiles and contains the user, server, and rule table with password hints.\\
|
|
\ActivityID{ACT-05} & Log document history and AI usage & \texttt{Todo} & The newest version entry is recorded at the top of the history table and links to the changed chapters, with any AI assistance logged.\\
|
|
\end{tabularx}
|
|
|
|
\section{Work-in-Progress Policy}
|
|
\index{work in progress!limit}
|
|
The \texttt{In progress} column is limited to two cards. The limit is paired
|
|
with a rule that a blocked card returns to \texttt{Todo} with its blocker
|
|
recorded. The limit was chosen deliberately to avoid uncontrolled parallel work,
|
|
especially because this assignment is sequential in places.
|
|
|
|
\section{Evidence}
|
|
\index{evidence!Kanban board}
|
|
\begin{figure}[htbp]
|
|
\centering
|
|
\includegraphics[width=\linewidth]{figures/kanbanboard.png}
|
|
\caption{Kanban board after the assignment cards were added, showing the
|
|
work-in-progress limit on the \texttt{In progress} column.}
|
|
\label{Figure:KanbanBoard}
|
|
\end{figure} |