Merge pull request #297 from andriujoseba/build/266-task-list-heading

docs: name the epic task-list heading
This commit is contained in:
Daniel Marin 2026-08-04 15:20:56 +01:00 committed by GitHub
commit 1a9fdde8fc
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
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` When an acceptance produces more than one issue, mint an **epic** (`epic`
label): the approach, the decisions, the constraint list, and a label): the approach, the decisions, the constraint list, and a
dependency-ordered task list of child issues. Children reference the epic; dependency-ordered checklist of child issues. Children reference the epic;
the epic's checklist is the progress view. Builders never pick 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. itself. Keep the checklist current — a stale epic misleads every scan.
Repositories that adopt version epics follow [RELEASES.md](RELEASES.md). 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).