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
@@ -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