Task 02 - Track your work (15 minutes)
Introduction
Agile project management is a key component of building a modern DevOps culture at your organization. If you are new to Agile or just want a refresher, we recommend you review the following articles:
To help you with Agile project management, we have GitHub project boards. With GitHub project boards, you can quickly and easily start tracking your backlog, as well as tasks, issues, bugs, and features associated with your project.
Review the following introduction to GitHub project boards: GitHub project boards.
Description
In this task, you will show the Munson’s Pickles and Preserves team how to perform a variety of tasks around project and work tracking.
The key tasks are as follows:
- Add other learners from your team room as contributors to your repository.
- Create a new project using the Kanban template.
- Ensure that this new project is linked with your repository.
- Use the project board to create five draft issues in total, named
Issue 1
,Issue 2
,Issue 3
,Issue 4
, andIssue 5
. When creating each issue, make sure to assign an owner for each issue to someone from your team room. Then, convertIssue 3
from a draft issue to an issue and then select the repository you have created. Look at the difference between a draft and your convertedIssue 3
issue. - Move all of your issues to the “Ready” column and convert each one from a draft to an issue.
- Move
Issue 1
to the “In Progress” column. - Ask the team member to whom you assigned
Issue 1
to close the issue. Review your project board to see if the issue automatically moved to the “Done” column. - Create a new view to show all of your issues as a table.
- Add a custom field to your issue. The custom field should be called “Complexity” and will be a single select type with the following options: Very Easy, Easy, Hard, and Very Hard.
Success Criteria
- You have added one or more collaborators to your repo.
- You have a project board using the automation Kanban template. This project board contains five issues. Of those, four are open and a team member closed the fifth.
- New issues appear under the “New” column.
- Closed issues automatically appear under the “Done” column.
- You have a table view in addition to your Backlog Board.
- You have a custom field called Complexity on your issues.
Learning Resources
- Creating a project board in GitHub
- Enable GitHub Issues on a repo
- Inviting collaborators to a personal repository
- Learn more about automation with project boards
- Adding issues to a project
- Customizing views
Solution
Expand this section to view the solution
- In order to use issues in a forked repository, you need to enabled them.
- In your repository, go into Settings
- Within settings, scroll down a little bit and find Issues. The checkbox will probably be uncheck, select the checkbox to select it to add issues to your repo.
- You may only assign tickets to other team members if those members have accepted invitations to be collaborators on the repository.
- The following steps will allow you to add one or more collaborators:
- In your repository, select Settings from the options menu.
- In the Access menu on the left-hand side, choose the Collaborators option. If you have two-factor authentication enabled for your account, you may be prompted for additional authentication.
- Select the Add people option from the Manage access section.
- A dialog box will appear. Enter the e-mail address or username of any team members you wish to add.
- Team members will need to accept invitations before this process is complete.
- The following steps will allow you to create an automated Kanban board:
- In your repository, select Projects from the options menu.
- Select the drop-down arrow in the Link a project button and select New Project from the menu. Then select the New project button.
- Select Kanban in the project templates.
- Select Create to generate the project board.
- The following steps will allow you to create and work with GitHub Issues:
- In your project board, select the Add Item option for the Backlog card. Enter the text for your issue.
-
Hover over the new card and select the ellipsis that appears. Select the ellipsis and choose Convert to issue from the menu.
- Make sure you select the correct TechExcel repository for each draft item you convert to an issue.
- New issues, if linked properly, should show up in the “Backlog” column. Once you set the issue to a status of Closed, it should move to the “Done” column in the project board. If you are viewing the issues from the Kanban project board, you will be able to drag issues across columns.