knowledge-kitchen / scrum / github

GitHub Task Boards

It is possible in GitHub’s Projects tab to create Scrum-style Task Boards that show User Stories and Tasks and Spikes organized into visual groupings.

GitHub task board set up with user stories in the sprint backlog and nicely labeled tasks

Each repository must have a separate Task Board set up for each Sprint.

GitHub’s Task Boards are relatively primitive and require a good amount of maintenance to keep them up-to-date. But they can be extremely useful for keeping track of the status of a sprint.

Set up a GitHub Task Board

Create a GitHub “Project Board” that works as a Task Board for a Scrum-style Sprint:

  1. Go to a repository
  2. Click on the Projects tab
  3. Create a new Project and name it something like, Sprint 1 Task Board

Configure it to be Scrum-friendly

Make this into a Scrum-style Task Board by adding the following columns:

  1. Sprint Backlog (User Stories) - this will contain the User Stories to be done within the given Sprint
  2. To do (Tasks) - this will contain the individual tasks that are necessary to implement the User Stories in Sprint Backlog
  3. In process (Tasks) - tasks will be moved here from the To Do column once they are actively being worked on
  4. Awaiting review (Tasks) - tasks that have been completed but require peer review before merging into the trunk should be moved here
  5. Done (Tasks) - tasks will be moved here when they are completed

Fill in the Task Board with Issues

Add all User Stories for the given Sprint into the Sprint Backlog column.

Search for user stories for a given Sprint in GitHub

Add all Tasks for each User Story into the To Do column

Search for tasks for a given Sprint in GitHub

Keep the Task Board Up-To-Date

Maintain the Task Board as you work on the Sprint.

Closing a Task Board at completion of a Sprint

Task boards serve as an archive of what was and was not accomplished within each Sprint.