Skip to content

Commit 19dd425

Browse files
author
Randy Pagels
committed
Enhance project management documentation with new features and workflows
- Added quiz questions about converting checklist items into sub-issues. - Expanded introduction to include project layout options and checklist conversion. - Updated how-to guides to include enabling workflows and converting checklist items. - Added summary points on comparing Projects vs Projects (Classic) and layout options.
1 parent f742334 commit 19dd425

File tree

7 files changed

+82
-1
lines changed

7 files changed

+82
-1
lines changed

learn-pr/github/manage-work-github-projects/7-knowledge-check.yml

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,3 +68,25 @@ quiz:
6868
- content: "Danger zone"
6969
isCorrect: true
7070
explanation: "Correct!"
71+
- content: "What is the benefit of converting checklist items into sub-issues?"
72+
choices:
73+
- content: "It allows you to embed a checklist within an issue."
74+
isCorrect: false
75+
explanation: "Checklists are already supported in issues. Converting items creates trackable sub-issues."
76+
- content: "It turns checklist items into standalone issues with status and metadata."
77+
isCorrect: true
78+
explanation: "Sub-issues appear as separate items with their own tracking in Projects."
79+
- content: "It automatically resolves the parent issue."
80+
isCorrect: false
81+
explanation: "Sub-issues are linked but don't auto-close the parent issue."
82+
- content: "Where can you go to enable default workflows for a Project?"
83+
choices:
84+
- content: "In the Project's README editor"
85+
isCorrect: false
86+
explanation: "README is for documentation, not automation."
87+
- content: "From the three-dot menu in the top-right of your Project"
88+
isCorrect: true
89+
explanation: "The three-dot menu contains the Workflows option where default automation can be configured."
90+
- content: "Under repository settings"
91+
isCorrect: false
92+
explanation: "Project workflows are configured within the Project view itself, not the repo settings."

learn-pr/github/manage-work-github-projects/includes/1-introduction.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,8 @@ Learning objectives:
1111
- Understand how to organize your Project
1212
- Gain insight on how to edit the visibility, access, and management of your Project
1313
- Know how to develop automation and insights from your Project
14+
- Understand project layout options such as boards, lists, and timeline views
15+
- Learn how to convert checklist items into sub-issues
1416

1517
Prerequisites:
1618

learn-pr/github/manage-work-github-projects/includes/3-how-to-create-project.md

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
1-
Imagine you want to organize your team's feature backlog. Projects, GitHub's built-in program-management tool, is a perfect way to organize and prioritize your team's work in a single space.
1+
GitHub Projects is a powerful planning and tracking tool that gives your team flexible views—like tables, boards, and timelines—to organize your work and see the bigger picture.
2+
3+
Imagine you want to manage your team’s feature backlog in one place. This built-in tool makes it easy to organize, prioritize, and track everything in a single view.
24

35
In this unit, you learn how to:
46

@@ -78,4 +80,29 @@ You can bulk add issues and pull requests to an existing repository to save time
7880

7981
1. Once you're ready to add the issues and pull requests to your Project, select the green button titled **Add selected items** in the bottom right corner.
8082

83+
## Project workflows
84+
85+
To help streamline work, GitHub Projects supports **default workflows**. These allow items like issues and pull requests to be automatically added to a Project and marked with an initial status, like "Todo".
86+
87+
To enable a workflow:
88+
89+
1. Open your Project.
90+
2. Select the three-dot menu in the top-right and choose **Workflows**.
91+
3. Choose a trigger like “Item added to project”.
92+
4. Set values, such as **Status: Todo**.
93+
5. Select **Save and turn on workflow**.
94+
95+
## Convert checklist items into sub-issues
96+
97+
As of February 2025, GitHub Projects supports converting checklist items into sub-issues. This feature makes it easier to break down tasks into smaller, trackable work items—directly from an issue.
98+
99+
To convert a checklist item:
100+
101+
1. Create or open an issue that contains a checklist.
102+
2. Hover over the checklist item.
103+
3. Click the **...** menu next to the item.
104+
4. Select **Convert to sub-issue**.
105+
106+
This creates a linked issue that appears in your Projects view with its own status, metadata, and tracking. Sub-issues provide better visibility into related work and replace the older tasklist block feature, which was deprecated on April 30, 2025.
107+
81108
In the next unit, you'll learn how to organize and prioritize your Project in order to keep your tasks on track.

learn-pr/github/manage-work-github-projects/includes/4-how-to-organize-your-project.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,3 +83,15 @@ Let's walk through how to get your board view up and running.
8383
Now, you can drag and drop issues and pull requests to the various columns.
8484

8585
:::image type="content" source="../media/4-project-boards.png" alt-text="Screenshot example of a Project board with four columns labeled; no status, todo, in-progress, done.":::
86+
87+
## Project workflows
88+
89+
To automate common actions, GitHub Projects includes built-in workflows that help organize and update project items automatically.
90+
91+
For example, when a new issue is added to your Project, a default workflow can set its status to "Todo". Here's how to enable a workflow:
92+
93+
1. Open your Project.
94+
2. Select the **** menu in the top-right and choose **Workflows**.
95+
3. Select a trigger (e.g., "Item added to project").
96+
4. Configure values like **Status: Todo**.
97+
5. Click **Save and turn on workflow**.

learn-pr/github/manage-work-github-projects/includes/5-how-to-organize-automate-project.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,4 +102,16 @@ Here are steps on how to navigate to them:
102102

103103
:::image type="content" source="../media/5-danger-zone-options.png" alt-text="Screenshot of the Danger zone section with the option to change visibility, close Project and delete Project with delete Project highlighted.":::
104104

105+
## Converting checklist items to sub-issues
106+
107+
GitHub Projects now supports converting checklist items into sub-issues for better task tracking and hierarchy.
108+
109+
To use this feature:
110+
111+
1. Open any issue that includes a checklist.
112+
2. Hover over a checklist item and click the **...** (more options) button.
113+
3. Select **Convert to sub-issue**.
114+
115+
This creates a dedicated issue linked back to the original one, which will also appear in your Projects view for tracking.
116+
105117
Next up, we'll review insights and automation in Projects.

learn-pr/github/manage-work-github-projects/includes/6-insight-automation-with-projects.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,3 +88,5 @@ Learn more about automating workflows for your Project in the article *Automatin
8888
### GraphQL API
8989

9090
If you're using GraphQL in GitHub, you can utilize an API to help automate your Project. For more information on using GraphQL API, see the article, *Using the API to Manage Projects* at the end of this module.
91+
92+

learn-pr/github/manage-work-github-projects/includes/8-summary.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@ You learned how to:
44

55
- Build an organization Project
66
- Automate and organize your Project
7+
- Compare Projects vs Projects (Classic)
8+
- Use layout options like boards, tables, and timelines
9+
- Enable default workflows to automate project tasks
10+
- Convert checklist items into sub-issues for better tracking
711

812
## Learn more
913

0 commit comments

Comments
 (0)