Skip to content

Align triage.md with current triage process#13030

Merged
BagToad merged 3 commits intotrunkfrom
cleanup-outdated-triage-doc
Mar 25, 2026
Merged

Align triage.md with current triage process#13030
BagToad merged 3 commits intotrunkfrom
cleanup-outdated-triage-doc

Conversation

@tidy-dev
Copy link
Contributor

Summary

Updates docs/triage.md to reflect the current triage process used by the team.

Key changes

  • Bug triage: Removed requirement for standalone acceptance-criteria comment. Bugs are triaged via reproduction + bug + priority label.
  • Enhancement triage: Goal is now to remove needs-triage by classifying to an end-state (bug, enhancement, ready-for-review, or close), rather than leaving needs-triage on.
  • Labels: Removed references to help wanted candidate, core, needs-investigation labels that are no longer part of the triage workflow. Added current automation labels (unable-to-reproduce, suspected-spam, off-topic, no-help-wanted-issue).
  • PR triage: Clarified that triage is a quick validity check, not a review. Added ready-for-review workflow and auto-assignment.
  • Added automated workflows table documenting label-triggered automations.
  • Removed: Weekly PR audit section (superseded by automated stale PR handling), useful aliases section (stale gist link), discuss label details.
  • Preserved: Bug priority table, spam/abuse handling, community examples section.

Closes https://github.com/github/gh-cli-and-desktop/issues/3 (partial)

@tidy-dev tidy-dev marked this pull request as ready for review March 25, 2026 13:52
@tidy-dev tidy-dev requested a review from a team as a code owner March 25, 2026 13:52
@tidy-dev tidy-dev requested review from BagToad and Copilot March 25, 2026 13:52
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates docs/triage.md to match the team’s current First Responder triage workflow, emphasizing label-driven “end states” (remove needs-triage by classifying/closing) and documenting automation-triggered behaviors.

Changes:

  • Replaces the prior weekly triage guidance with a “Quick Guide” decision flow for issues and PRs.
  • Updates bug/enhancement/PR triage steps to reflect current labels and automation (e.g., unable-to-reproduce, ready-for-review, suspected-spam, off-topic).
  • Adds an “Automated Workflows” table and removes older/stale sections (weekly PR audit, aliases, deprecated labels).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

tidy-dev and others added 2 commits March 25, 2026 06:56
Copy link
Member

@BagToad BagToad left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

great thank you ❤️

@BagToad BagToad merged commit a32d004 into trunk Mar 25, 2026
6 checks passed
@BagToad BagToad deleted the cleanup-outdated-triage-doc branch March 25, 2026 17:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants