docs/triage.md
The primary responsibility of the First Responder (FR) during their weekly rotation is to triage incoming issues and pull requests from the open source community. An issue is considered "triaged" when the needs-triage label is removed.
Pick an issue from the triage queue.
Your goal: Do what is needed to remove the needs-triage label.
Can we close it?
invalid or suspected-spam (auto-closes)invalid, remove content, report, block (see Spam and abuse)off-topic (auto-closes with comment)Is it a bug?
bug and a priority label (priority-1, priority-2, or priority-3)unable-to-reproduce (auto-requests info, 14-day timer)Is it an enhancement?
enhancement (auto-posts backlog comment)more-info-needed (14-day timer)Is it a pull request? (see Community pull requests)
invalid (auto-closes)no-help-wanted-issue (auto-closes with comment)ready-for-review and run CI (auto-removes needs-triage, auto-posts acknowledging comment)The needs-triage label is automatically removed when end-state labels (enhancement, bug, ready-for-review) are applied or the issue is closed.
bug and a priority labelunable-to-reproduce (auto-requests info, 14-day timer) or request clarification with more-info-needed| Priority | Description |
|---|---|
priority-1 | Affects a large population and inhibits work. Escalate internally via the appropriate incident channel; may require a hotfix. |
priority-2 | Affects more than a few users but does not prevent core functions |
priority-3 | Affects a small number of users or is largely cosmetic |
Do:
more-info-needed while waiting for clarificationenhancement label once value is clear (auto-posts backlog comment)Don't:
Community pull requests receive needs-triage (as well as external) just like issues do, but are not meant to be reviewed as part of triage.
The triager's responsibility is to do a quick pass:
invalid label (auto-closes). Block user if necessary.no-help-wanted-issue (auto-closes with comment).ready-for-review and run CI (auto-removes needs-triage, auto-posts acknowledging comment).The pull request will be auto-assigned to an engineer on the team; that engineer will wait to review until needs-triage is removed.
The primary goal of triaging spam and abuse is to remove distracting and offensive content from our community.
invalid label (auto-closes as "won't do").| Label | Automation |
|---|---|
needs-triage | Auto-added on open; removed when classified or closed |
more-info-needed | Auto-closes after 14 days without response |
unable-to-reproduce | Auto-adds more-info-needed + posts comment |
enhancement | Auto-posts backlog comment |
invalid | Auto-closes immediately |
suspected-spam | Auto-closes immediately |
off-topic | Auto-posts explanation comment + closes |
no-help-wanted-issue | Auto-posts explanation comment + closes |
ready-for-review | Auto-removes needs-triage + posts acknowledging comment |
We want our project to be a safe and encouraging open-source environment. Below are some examples of how to empathetically respond to or close an issue/PR: