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 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
This commit is contained in:
1 parent
a2a6baa265
commit
20a7624134
3 files changed
+17
-2
No files matched your search
+11
-1
@@ -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
|
||||
<!-- /wikitool:bumps -->
|
||||
|
||||
### 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,
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in new issue
Block a user