Triage process
April 17, 2026 ยท View on GitHub
This is heavily inspired by this blog post, but that's a long read, so here's the short version.
The goal of triage is to make sure that the following are handled quickly:
- New bugs or issues, some of which might be high priority
- Consumer (developer or administrator) updates to an issue which might not be on the immediate radar of a contributor
The goal is for the project to be responsive to outside requests, while shielding most of the team from the interrupt-y work of watching the triage queue. An additional goal is to protect and respect the time of the triager / support user.
For triage, the goal is to handle all the bugs on the following lists (searches):
- Untriaged issues
- User feedback issues updated more than 3 days ago -- YOU NEED TO UPDATE THE DATE IN THE QUERY
When doing triage, the goal is to quickly process issues, getting them into the right "bin". For small issues and user questions, it's reasonable to reply in the issue with documentation or a reference to another issue, but you should avoid fixing anything when triaging -- if you're making PRs during triage, you're doing it wrong.
At the end of reading an issue, you should do one of the following:
-
If the issue is clear and applies to serving, ensure it has the correct
/kindand/areaassigned. If you know enough, feel free to/assignto an individual, but area assignments should be sufficient for triage. Also consider if it is a/good-first-issue. After this, also mark the issue as/triage accepted, so it drops out of the list above. -
Move it to the correct repo (for example, Istio-specific questions should probably go to
net-istio). In some cases, you may need to create a new issue in the new repo and link / copy the current issue. If you do this, be sure to@mentionthe requester and others on the old issue, and then/closethe issue is serving with a link to the other repo. -
If it's not clear what the problem or issue is, add a note for the requester (or occasionally some other user on the thread), make sure that there is a reasonable
/kindon the issue and mark it as/triage needs-user-inputso that it's off the list for a few days. If aneeds-user-inputissue persists for longer than a week or so (past a second followup), it's reasonable to/closethe issue and encourage the requester to reopen if they have more detail. -
If the request can be resolved with documentation, is infeasable, or complete, follow up directly in the issue with the information, and
/closethe issue.