Important
This page was copied from https://github.com/dart-lang/sdk/wiki and needs review. Please contribute changes to bring it up-to-date - removing this header - or send a CL to delete the file.
When doing a large task that involves multiple people or changes to the codebase, it helps to have a single issue that tracks the overall state of the task. This is called a "meta-issue". It describes the overall goal and links to more specific issues for individual pieces of work.
If a meta-issue involves work across multiple areas, it should have the "area-meta" label. It should also be assigned to a person who is responsible for coordinating the work across teams and keeping the meta-issue updated. If all of the tasks are within a single area, the meta-issue should instead be labeled with that area. In that case, it doesn't need an assignee, though having one doesn't hurt.
Like other specific issues, it should have a type label that describes the type of the overall change: type-bug, type-enhancement, etc.
The meta-issue's body text should give a high-level overview of the change followed by a task list for all the sub-issues. Each entry should have a very brief description and a link to the sub-issue. A task list can be created using the following Markdown:
- [ ] item
- [ ] item
- [x] checked item
Once a sub-issue is completed, its entry should be checked. If applicable, the first release to contain the fix should be mentioned as well.
Occasionally new sub-issues come up. For example, a bug might be found in the solution to a previously-completed sub-issue. To add these to the meta-issue, a triager should both add a comment linking to the new sub-issue and add it to the task list. Adding a comment notifies interested parties of a new blocking issue, and updating the task list ensures that the original post continues to provide an up-to-date view of everything required for the meta-issue.
When all of the sub-issues are closed and the owner of the meta-issue decides the overall task is complete, they should close the meta-issue.
See this issue for a good example of a meta-issue.