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: historical and a canonical frontmatter 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.

Historical snapshotCurrent reference
Ability Atlas & SynergiesAbility Atlas and Synergies
Combat Core & LoopCombat Core and Loop
Enemies, Waves & BossesEnemies, Waves and Bosses
GM Console & ToolsGM Console and Tools
Heroes & ClassesHeroes and Classes
Loot, Inventory & CraftingLoot, Inventory and Crafting

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.