docs: name the epic task-list heading

This commit is contained in:
Andriujose 2026-08-04 13:42:24 +00:00
parent f899bb5690
commit 08b817b814
2 changed files with 10 additions and 2 deletions

View file

@ -122,8 +122,11 @@ expected.
When an acceptance produces more than one issue, mint an **epic** (`epic`
label): the approach, the decisions, the constraint list, and a
dependency-ordered task list of child issues. Children reference the epic;
the epic's checklist is the progress view. Builders never pick the epic
dependency-ordered checklist of child issues. Children reference the epic;
that checklist is the progress view. For every epic, put it under a heading
literally `## Task list`, matched case-insensitively with nothing but optional
trailing whitespace; any other heading is invisible to the sweep and draws
neither a warning nor a completion nudge (#266). Builders never pick the epic
itself. Keep the checklist current — a stale epic misleads every scan.
Repositories that adopt version epics follow [RELEASES.md](RELEASES.md).

5
changelog.d/266.md Normal file
View file

@ -0,0 +1,5 @@
### Changed
- TRIAGE.md now tells every epic author to put its progress checklist under
the literal `## Task list` heading, because any other heading is silently
invisible to the completion sweep (#266).