feat: Assignment 1; initialization

devopsKanbanSetup.tex

@@ -0,0 +1,95 @@
+\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]{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}