Wiki Governance & Audit
This page records how the project wiki distinguishes current guidance from retained project history. The wiki is also a source for MuffinCore indexing, so classification must remain explicit and machine-readable.
Documentation contract
- Current implementation guidance remains in the normal topic categories and is the canonical link target.
- Superseded or overlapping material is retained, never silently discarded.
- A retained snapshot uses
status: historicaland acanonicalfrontmatter field naming its current page. - The site builder publishes snapshots under a
history-URL, groups them under History, and displays a warning with a link to the current reference. - Historical claims remain useful as evidence of earlier architecture, terminology, and design intent, but must not override current code-derived documentation.
- Meaningful audits and classification changes are recorded here and surfaced on Home.
Audit โ 2026-08-08
Six filename pairs produced identical URL slugs because & and and normalize the same way. The later, code-derived pages are now canonical; the earlier broad overviews remain available as historical snapshots.
The audit also corrected homepage links to canonical pages, repaired a heading-anchor link, and updated the static-site parser so wrapped list items remain part of their list entry. Post-build validation found no unresolved wiki links.
Guidance for future passes
When two documents overlap, compare their sources and last_updated metadata. Prefer the page verified against the current code or live runtime as canonical. Mark the other page historical and link it forward; do not erase it. If both contain current, non-overlapping facts, consolidate those facts into the canonical page before classifying the older document.