From 08b817b81497fa874e46045c188b13b32302edc6 Mon Sep 17 00:00:00 2001 From: Andriujose <43181885+andriujoseba@users.noreply.github.com> Date: Tue, 4 Aug 2026 13:42:24 +0000 Subject: [PATCH] docs: name the epic task-list heading --- TRIAGE.md | 7 +++++-- changelog.d/266.md | 5 +++++ 2 files changed, 10 insertions(+), 2 deletions(-) create mode 100644 changelog.d/266.md diff --git a/TRIAGE.md b/TRIAGE.md index d8ee1be..b7451bb 100644 --- a/TRIAGE.md +++ b/TRIAGE.md @@ -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). diff --git a/changelog.d/266.md b/changelog.d/266.md new file mode 100644 index 0000000..9d6bd0b --- /dev/null +++ b/changelog.d/266.md @@ -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).