Add information to issue triage page#182145
Conversation
stuartmorgan-g
commented
Feb 10, 2026
stuartmorgan-g
commented
- Adds an overview at the top about how triage works from a very high level. Right now the page discusses primary and secondary/team triage without ever actually introducing those concepts. Also sets some expectations around timelines, as we do for reviews in other docs.
- Clarifies that some sub-sections of the team assignment flow chart are additional steps rather than alternate path (especially since the intro says to stop once a team assignment matches, so it was unclear that the sub-bullets applied as well).
- Adds more discussion of common labels.
- Adds an overview at the top about how triage works from a very high level. Right now the page discusses primary and secondary/team triage without ever actually introducing those concepts. Also sets some expectations around timelines, as we do for reviews in other docs. - Clarifies that some sub-sections of the team assignment flow chart are additional steps rather than alternate path (especially since the intro says to stop once a team assignment matches, so it was unclear that the sub-bullets applied as well). - Adds more discussion of common labels.
|
Looking at these docs recently I noticed some gaps where we hadn't written down some things that we mostly take for granted as institutional knowledge. |
![gemini-code-assist[bot]](proxy.php?url=https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request updates the issue triage documentation in docs/triage/README.md. It adds a new 'Triage Overview' section, clarifies that sub-steps in the team assignment flow are additional actions by adding 'And:', and expands the section on additional labels with more guidance on category and platform labels. The changes improve the clarity and usefulness of the documentation. I have a couple of minor suggestions to further improve readability.
Piinks
left a comment
Piinks
left a comment
There was a problem hiding this comment.
Ah thank you, realizing there was a lot of things there were just known. Thanks for writing it down!
There might be some overlap with https://github.com/flutter/flutter/blob/master/docs/contributing/issue_hygiene/README.md#labels
Skimming through, should this page also mention:
found in release..?r:..resolution labels? (e.g. fixed, invalid, duplicate)browser-for web issues that are happening on specific browsers?- I noted
waiting for customer response, but it looks like that is already mentioned. 👍
Do we actually consume this label? I'll start a thread to discuss.
Added duplicate, and some discussion of invalid usage (including a new section for another common use of invalid). I'm not sure the others are generally used in initial triage?
Good call, added! |
I don't think so, maybe to signal oh this had not been reproduced in a more recent release? I am not married to it. IIRC the previous triage team used it to identify and see if older issues were still reproducing based on what release they had last checked.
The previous triage team would use these, even circling back to closed issues to mark them I am fine keeping or omitting. I just scanned through the labels to see what might be worth mentioning based on how the last team operated. |
|
So far I haven't heard from anyone who was consuming |
stuartmorgan-g
added
the
autosubmit
auto-submit
bot
removed
the
autosubmit
|
autosubmit label was removed for flutter/flutter/182145, because The base commit of the PR is older than 7 days and can not be merged. Please merge the latest changes from the main into this branch and resubmit the PR. |
stuartmorgan-g
added
the
autosubmit
flutter-dashboard
bot
removed
the
autosubmit
Roll Flutter from 1141b2bdce66 to 46fb7210422d (38 revisions) flutter/flutter@1141b2b...46fb721 2026-03-02 [email protected] [rules] Fix a few issues in the full-length rules file (flutter/flutter#182725) 2026-03-02 [email protected] Roll Dart SDK from 8063f5f5ac60 to e86dbe9aa742 (1 revision) (flutter/flutter#183120) 2026-03-02 [email protected] [web] Roll Chrome to 145 (flutter/flutter#182860) 2026-03-02 [email protected] Roll Skia from 61c0e71760f5 to e180358b7a7a (1 revision) (flutter/flutter#183118) 2026-03-02 [email protected] Roll Packages from a27d7c5 to faa4e22 (4 revisions) (flutter/flutter#183117) 2026-03-02 [email protected] Add information to issue triage page (flutter/flutter#182145) 2026-03-02 [email protected] Roll Skia from cc8ce92481f2 to 61c0e71760f5 (2 revisions) (flutter/flutter#183103) 2026-03-02 [email protected] Roll Skia from 4cf3cd27b620 to cc8ce92481f2 (1 revision) (flutter/flutter#183100) 2026-03-02 [email protected] Roll Fuchsia Linux SDK from zN2ZV9QD0LD8acUFF... to 0dCDM2oORHwDf_pyb... (flutter/flutter#183101) 2026-03-01 [email protected] Update fl_texture_gl.h (flutter/flutter#182999) 2026-03-01 [email protected] Roll Skia from be1362b5ca4e to 4cf3cd27b620 (1 revision) (flutter/flutter#183096) 2026-03-01 [email protected] Roll Skia from b9210eb7005f to be1362b5ca4e (1 revision) (flutter/flutter#183092) 2026-03-01 [email protected] Timeout when waiting for the correct sized frame from Flutter. (flutter/flutter#182971) 2026-03-01 [email protected] Roll Skia from 28172a4e03af to b9210eb7005f (1 revision) (flutter/flutter#183088) 2026-03-01 [email protected] Roll Fuchsia Linux SDK from D7IYacJUCpvc_1iU_... to zN2ZV9QD0LD8acUFF... (flutter/flutter#183076) 2026-02-28 [email protected] Roll Dart SDK from cdf45eaf995e to 8063f5f5ac60 (1 revision) (flutter/flutter#183064) 2026-02-28 [email protected] Roll Dart SDK from 54451fcdbcf9 to cdf45eaf995e (1 revision) (flutter/flutter#183057) 2026-02-28 [email protected] Roll Skia from c8bcc27f5319 to 28172a4e03af (3 revisions) (flutter/flutter#183056) 2026-02-28 [email protected] Roll Dart SDK from 148d91b8a603 to 54451fcdbcf9 (2 revisions) (flutter/flutter#183051) 2026-02-28 [email protected] [A11y] in calendar date picker, remove SemanticsService.sendAnnouncement usage for android. (flutter/flutter#182918) 2026-02-28 [email protected] Add desktop review teams (flutter/flutter#182972) 2026-02-28 [email protected] [framework] Fix Text.semanticsIdentifier being absorbed by ancestor nodes (flutter/flutter#181795) 2026-02-28 [email protected] Roll Skia from b150186d3e23 to c8bcc27f5319 (5 revisions) (flutter/flutter#183032) 2026-02-28 [email protected] [Impeller] For Android hardware buffers on Vulkan, use an alpha value of 1 if the buffer format always has opaque alpha (flutter/flutter#182974) 2026-02-27 [email protected] Adds float32 output to `Image.toByteData()` in float32 Image (flutter/flutter#182847) 2026-02-27 [email protected] Roll Dart SDK from 1cdb7dfd913e to 148d91b8a603 (1 revision) (flutter/flutter#183025) 2026-02-27 [email protected] Roll Fuchsia Linux SDK from G1GwOdVt5bM7GjMSY... to D7IYacJUCpvc_1iU_... (flutter/flutter#183021) 2026-02-27 [email protected] When impellerc fails with a long shader compilation error, truncate it and output to a file (flutter/flutter#182786) 2026-02-27 [email protected] Add missing mutation-safe delegate iteration and use idomatic syntax (flutter/flutter#183018) 2026-02-27 [email protected] Exclude arm64 if any dependencies do and print warning when using Xcode 26 (flutter/flutter#182913) 2026-02-27 [email protected] Ignore unawaited_futures lint in dev/automated_tests (flutter/flutter#182922) 2026-02-27 [email protected] licenses_cpp: pre-land changes for perfetto update (flutter/flutter#182965) 2026-02-27 [email protected] Re-add extended attribute removed by SwiftPM (flutter/flutter#183011) 2026-02-27 [email protected] Fixes future warning for `await`ing `Future` returns in `async` bodies inside `try` blocks (flutter/flutter#182301) 2026-02-27 [email protected] Roll Skia from ed220c490eea to b150186d3e23 (2 revisions) (flutter/flutter#183014) 2026-02-27 [email protected] Fix issue where web embedder is synthesizing key up events too eagerly (flutter/flutter#180692) 2026-02-27 [email protected] chore: Don't unconditionally check tools/gn formatting (flutter/flutter#182973) 2026-02-27 [email protected] Roll Packages from e1d0169 to a27d7c5 (8 revisions) (flutter/flutter#183009) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC [email protected],[email protected] on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose ...
- Adds an overview at the top about how triage works from a very high level. Right now the page discusses primary and secondary/team triage without ever actually introducing those concepts. Also sets some expectations around timelines, as we do for reviews in other docs. - Clarifies that some sub-sections of the team assignment flow chart are additional steps rather than alternate path (especially since the intro says to stop once a team assignment matches, so it was unclear that the sub-bullets applied as well). - Adds more discussion of common labels. --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2 participants
