You can track progress with Sub-issues in GitHub Issues
Back to Top
To reach a broader audience, this article has been translated from Japanese.
You can find the original version here.
Introduction
#Last autumn, I wrote an article about trying out the Sub-issues feature of GitHub Issues when it became available in private preview.
At the beginning of this year, this feature has entered public preview, and all users can now try it.
Visualization of Parent-Child Relationships and Progress in Projects
#In the article during the private preview, I introduced a method for visualizing parent-child relationships of issues using grouping.
By specifying Parent issue
in Group By
in the Table view or Roadmap view, you can express the hierarchy. At this time, a progress bar based on the status of sub-issues is also displayed.
Visualizing Progress Using the Progress Field
#Now, even without specifying groups, you can visualize progress by using a dedicated progress field[1].
The usage is described in the official documentation.
About the progress fields of parent issues and sub-issues – GitHub Docs
I tried setting it up using the repository and project used in the previous article. The issues from the previous article have already been closed, so I added new Issues and Sub-issues.
In the settings of the parent issue, select the project to add.
As I wrote in the previous article, sub-issues are automatically added by the project's workflow, so you don't need to add them individually.
The issues and sub-issues have been added to the project.
Now, let's display the progress field.
From the menu that appears when you click the +
button, select Sub-issues progress
under Hidden fields
.
A column that displays the progress bar for the parent issue will be added.
Looks good. Let's hide the sub-issues using a filter and display only the parent issues. Just specify no:parent-issue
in the filter.
Now it's clean with only the parent issues and progress bars.
If you click Save
in this state, you can display this view at any time.
Conclusion
#GitHub Issues is steadily making progress.
Previously, there was a method to visualize progress using task lists within an issue, but by using Sub-issues and the progress field, you can see progress at the issue granularity, which I think could be useful in many situations. Why not try utilizing it in your project management?
It might have been possible even during the private preview, but I didn't notice. ↩︎