From 20a7624134a56861195eb579fea0562772bfbd10 Mon Sep 17 00:00:00 2001 From: Torben Nehmer Date: Sun, 4 Oct 2026 17:21:57 +0200 Subject: [PATCH] docs: kb/CONTRACT.md names unwritten scaffold sections and the Unfilled Template Sections finding (#94) Files changed: - CHANGES.md - VERSION - kb/CONTRACT.md Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2 --- CHANGES.md | 12 +++++++++++- VERSION | 2 +- kb/CONTRACT.md | 5 +++++ 3 files changed, 17 insertions(+), 2 deletions(-) diff --git a/CHANGES.md b/CHANGES.md index 1a12ebe..329e14d 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -59,7 +59,7 @@ concern - readable here, never shipped as something to parse. --- -## 8.0.0-beta.37 - 2026-10-04 - lint: Unfilled Template Sections - a section still holding only its template's TODO placeholders (advisory) +## 8.0.0-beta.38 - 2026-10-04 - kb/CONTRACT.md names unwritten scaffold sections and the Unfilled Template Sections finding **Author:** Torben Nehmer @@ -148,8 +148,18 @@ concern - readable here, never shipped as something to parse. - lint: a wikilink wrapped across a line break is its own finding; rename and rm see it - Page-material passages in type-spec.md, type-guidance.md and language-boundaries.md name subtype templates - kb/CONTRACT.md names section anchors in wikilinks and the Broken Anchors finding +- kb/CONTRACT.md names unwritten scaffold sections and the Unfilled Template Sections finding +### kb/CONTRACT.md names unwritten scaffold sections and the Unfilled Template Sections finding + +The stage contract pairs each page property with the `lint` finding that checks it, and its +"Every page should" list did not yet name the one the previous bump added. It now says that a +page leaves no section of its scaffold unwritten, that `lint` reports a section still made of +nothing but `TODO` placeholders as advisory *Unfilled Template Sections*, that the fix is writing +it from a source or retiring the page, and that a field the source does not give may keep its +`TODO` beside written lines. Found in the closing pass of Gitea #94. + ### lint: Unfilled Template Sections - a section still holding only its template's TODO placeholders (advisory) `lint` had no finding for a page without substance: every check measured structure, links, diff --git a/VERSION b/VERSION index f1c4d35..66148ea 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -8.0.0-beta.37 +8.0.0-beta.38 diff --git a/kb/CONTRACT.md b/kb/CONTRACT.md index 28eec7d..818b23a 100644 --- a/kb/CONTRACT.md +++ b/kb/CONTRACT.md @@ -176,6 +176,11 @@ Paths - advisory, not a hard error, so a corpus that predates the budget still p is worth naming - in the direction this page asserts it, not in both - [ ] Cite its hard facts (see [Provenance and citation](#provenance-and-citation)) - [ ] Duplicate no existing page +- [ ] Leave no section of its scaffold unwritten - `wikitool lint` reports a `##` section that + still holds nothing but its template's `TODO` placeholders as *Unfilled Template Sections* + (advisory). Write it from a source, or retire the page + ([instructions/page-lifecycle.md](../instructions/page-lifecycle.md)); a field the source + does not give may keep its `TODO` beside written lines - [ ] Appear in the catalog (guaranteed by `wikitool index rebuild`) ## Quotation cap