docs: kb/CONTRACT.md names section anchors in wikilinks and the Broken Anchors finding (#172)
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
4ec22d376d
commit
af8bcb5b57
3 files changed
+20
-2
No files matched your search
+10
-1
@@ -59,7 +59,7 @@ concern - readable here, never shipped as something to parse.
|
||||
|
||||
---
|
||||
|
||||
## 8.0.0-beta.35 - 2026-10-04 - Organisationsseiten: Personen als Abschnitt mit Aufstieg, entity_type organization, member-of, Lint-Befund broken_anchors
|
||||
## 8.0.0-beta.36 - 2026-10-04 - kb/CONTRACT.md names section anchors in wikilinks and the Broken Anchors finding
|
||||
|
||||
**Author:** Torben Nehmer
|
||||
|
||||
@@ -146,8 +146,17 @@ concern - readable here, never shipped as something to parse.
|
||||
- stack-close no longer records which model and effort ran each phase
|
||||
- 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
|
||||
<!-- /wikitool:bumps -->
|
||||
|
||||
### kb/CONTRACT.md names section anchors in wikilinks and the Broken Anchors finding
|
||||
|
||||
The stage contract's rules for writing a wikilink (§ Titles are identifiers) covered wrapped links
|
||||
but not `[[Title#Section]]`, which the previous bump made a checked form. It now says that the
|
||||
title part is the reference (the graph counts it, `rename` carries the anchor), that a stale
|
||||
anchor is reported as advisory *Broken Anchors*, and that a section is never an edge target.
|
||||
Found in the closing pass of Gitea #172.
|
||||
|
||||
### Organisationsseiten: Personen als Abschnitt mit Aufstieg, entity_type organization, member-of, Lint-Befund broken_anchors
|
||||
|
||||
Personen, von denen eine Quelle nur Namen, Rolle und Tätigkeitsbereich hergibt, waren bisher
|
||||
|
||||
@@ -122,6 +122,15 @@ read a link with a line break in it as a link. `wikitool lint` reports one as a
|
||||
Wikilinks* hard error, naming the title it folds to - the graph, `rename` and `rm` already read
|
||||
it as that title, so the fix is only to put it back on one line.
|
||||
|
||||
**A wikilink may name a section of its page: `[[Title#Section]]`.** The title part is the
|
||||
reference - the graph counts it as a link to `Title`, and `rename` carries the anchor along - so
|
||||
an anchor never makes a link broken. It can make one stale: a section renamed, or promoted to a
|
||||
page of its own ([instructions/page-lifecycle.md](../instructions/page-lifecycle.md)), leaves the
|
||||
link reaching the right page and the wrong place. `wikitool lint` reports an anchor that names no
|
||||
heading on its page as *Broken Anchors*, advisory - compared at any heading level, without case,
|
||||
inline-code backticks or extra whitespace. A section is never a target in `related:`; an edge
|
||||
points at a page.
|
||||
|
||||
Which *form* those titles take - spaces or kebab-case, singular or plural, what prefixes a
|
||||
decision record - is the instance's, in
|
||||
[kb/CONVENTIONS.md § Naming](CONVENTIONS.md#naming).
|
||||
|
||||
Reference in new issue
Block a user