article image

Contents

mameyose
recruit

You can track progress with Sub-issues in GitHub Issues

| 3 min read
Author: masahiro-kondo masahiro-kondoの画像
Information

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.

Group by parent issue

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.

Issue and sub-issues

In the settings of the parent issue, select the project to add.

Select project

Information

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.

Issues added

Now, let's display the progress field.

From the menu that appears when you click the + button, select Sub-issues progress under Hidden fields.

Set Sub-issues progress

A column that displays the progress bar for the parent issue will be added.

Show Sub-issues progress

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.

set filter

Now it's clean with only the parent issues and progress bars.

parent issue only view

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?


  1. It might have been possible even during the private preview, but I didn't notice. ↩︎

豆蔵では共に高め合う仲間を募集しています!

recruit

具体的な採用情報はこちらからご覧いただけます。