docs/Triaging-Dart-SDK-issues.md

Workflow

Look through issues that don't have an area assigned.
- Use the SDK triage query.
Does the issue relate to code in the SDK?
- Assign to the right area by adding an area-* label.
Is the issue in area-core-library?
- Assign the right library-* label, too.
Is it obvious if the issue is a bug or enhancement?
- Optional: Add type-bug or type-enhancement if you can.
Does the issue relate to code in another dart-lang project/package?
- Move the issue to the right repo by using the Transfer issue link.
Get emails when issues are tagged with labels you care about
- Use the Dart SDK email tool.

Issue Labels

Priority

Level of team urgency
- Should be the opinion of team and/or product management
- Can be affected by the quantity/priority of existing issues - If everything is P0, nothing is P0
- May evolve as other issues are resolved and new issues are opened
Levels
- P0: Drop everything and fix it.
  - For dev channel: blocks the release. Valid cherry-pick.
  - For release channel: worthy of a “dot” release
- P1: Planned for the in-progress release
  - Should be aligned with other work to ensure likely completion in current release
- P2: Important work for later release.
  - Should be done – eventually.
- P3: Maybe, someday
  - First candidates to close as “closed-not-planned”
When we enter cherry pick season for release X...
- P0 issues: are the only fixes that will be taken for release X
- P1-3 issues:
  - Milestone flag should be changed to release X+1 or
  - P1 issues can be changed to p2/3 and milestone flag removed

Using the `needs-info` label

If you need additional information from an issue reporter to triage or otherwise act on an issue, say so, and consider adding the needs-info label to the issue. Issues with a needs-info label are triaged by our no response bot; it will auto-close the issue after 14 days if the issue reporter does not respond.

Triage automation

We‘re experimenting with triage automation. You may see comments made by a @dart-github-bot - that’s related to our automation investigations. We may or may not continue experimentation here; for now, you can safely ignore these comments.

For the source for the triage tool, see https://github.com/dart-lang/ecosystem/tree/main/pkgs/sdk_triage_bot.

Follow up steps for Dart VM and Dart IO Library issues

Issues filed against the Dart VM (issues with label area-vm : VM issues) and IO library (issues with labels area-core-library library-io : io library issues) are triaged at least weekly by a member of the Dart VM team. Triaging a bug entails the following steps

Figure out if it is a bug, enhancement request, performance issue, general question, documentation issue or one of the other types and mark the issue appropriately as type-bug,type-question,type-enhancement,type-performance or one of the other types.
If additional information is needed for addressing the bug please add the label needs-info to the issue and a comment back to the person filing the issue asking for information
Review contents of the issue and assign one of 4 priorities listed below
- P0 - the issue critically impacts many users: somebody is actively working on it and daily updates will be posted on the issue, it is definitely a cherry pick candidate
- P1 - the issue blocks several users: it is desirable to address it in the next beta release, there will be weekly updates on the issue (could be a cherry pick to the previous stable release)
- P2 - the issue is represents an important issue for a small number of users or is of minor importance for many users: it is desirable to address it in the next stable release, there will be quarterly updates on the issue
- P3 - the issue is not critical and is not being actively addressed
If the priority is <= P2 then it is also assigned to a developer.
Assign a milestone to the issue based on the priority selected so that the expected resolution timeline is clear. At this point add the triaged label so that it is clear the issue has been looked at.