Skip to content

Clarify the team planning workflow and tool relationships on the planning and tracking docs page #46798

Open

Description

@tomarani99

Summary

The page Planning and tracking work for your team or project provides a helpful overview of the GitHub planning tools, but it could be more actionable for new users.

The page covers repositories, issue templates, labels, sub-issues, and project boards, but it does not always clearly explain how these tools fit together in a practical workflow.

Suggested improvement

I recommend improving the page to make the guidance easier to follow for people setting up a team project or cross-functional initiative for the first time.

Possible additions or clarifications:

  • Add a quick decision guide explaining when to choose a repository, issue, or project for tracking work
  • Clarify how issue templates and issue forms fit into the workflow and when to use each
  • Show a simple end-to-end example of how labels, sub-issues, and project views work together
  • Add stronger cross-links to the related docs for repositories, projects, labels, and sub-issues earlier in the page
  • Consider simplifying the flow for readers who are new to GitHub planning tools

Why this matters

This page is a key onboarding resource for teams using GitHub to plan work. Making the workflow clearer would help readers understand not just what the tools are, but when and how to use them together.

Related docs

Activity

  1. added
    triageDo not begin working on this issue until triaged by the team
    on Nov 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    triageDo not begin working on this issue until triaged by the team

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions