Rewrite docs/TriageProcess.md to be timeless and more comprehensive#66566
Open
danroth27 wants to merge 6 commits intodotnet:mainfrom
Open
Rewrite docs/TriageProcess.md to be timeless and more comprehensive#66566danroth27 wants to merge 6 commits intodotnet:mainfrom
danroth27 wants to merge 6 commits intodotnet:mainfrom
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
danroth27
commented
May 1, 2026
- Drop the Mermaid diagram (too complicated) - Restructure outcomes around actual milestones (N.0.x, .NET N Planning, Backlog) - Switch from type labels to GitHub issue type field (Bug/Feature/Task/Epic) - Reference Servicing.md, IssueManagementPolicies.md, repro.md instead of duplicating - Use Dan's verbatim text for investigations, feature priorities, docs, wrong-repo - Use Needs: Repro label; clarify 'milestone is intent, not commitment' - Drop 'what we triage' framing; set realistic response-time expectation Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Member
Author
|
Pushed 041a869 addressing review feedback. Summary of changes:
On the meta-comment about reviewing related docs together: I leaned hard into linking out rather than restating, so this doc is now mostly triage-specific logic — servicing bar lives in |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
danroth27
commented
May 1, 2026
… note, area-* label, expand Epic Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Rewrites docs/TriageProcess.md to describe the issue triage workflow for dotnet/aspnetcore in a more version-neutral, outcome-oriented way for both community reporters and new team engineers.
Changes:
- Replaces the previous narrative triage description with explicit triage outcomes and per-issue-type guidance (Bug/Feature/Task/Epic).
- Adds impact/severity assessment criteria for bugs and clarifies repo transfer behavior for wrong-repo issues.
- Updates references to related repo documentation (Issue Management Policies, repro guide, release planning, servicing).
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Rewrites
docs/TriageProcess.mdto be tighter, more comprehensive, and version-neutral. Also fills a small documentation gap indocs/IssueManagementPolicies.mdfor theNeeds: Reprolabel.What changed
Trimmed
Made timeless
.NET 11 Planning).servicing milestone (N.0.x),current release milestone (N.0-previewX),current-release planning milestone (.NET N Planning),Backlog. The doc no longer needs editing each release.Filled gaps the previous doc missed
Needs: Reprolabel automation inIssueManagementPolicies.md.Cross-document hygiene
Needs: *automation, and release scoping all defer to the existingServicing.md/repro.md/IssueManagementPolicies.md/ReleasePlanning.mddocs rather than restating them.Audiences
The rewrite makes both audiences explicit at the top: