plans

🧹 Cleanup and Streamline Plan

How the wiki stays canonical, curated, deterministic, and safe as source material grows.

Decisions#

  • Keep the public wiki static and Hugo-based.
  • Prefer curated reference pages over raw mounts.
  • Generate only sanitized summaries from structured safe inputs.
  • Keep raw artifact indexes visually separate from operator runbooks.
  • Keep generated output reproducible from source content and generator code.

Content ownership#

Content type Owner
Stable guides Hand-written Markdown under content/.
Hermes/service summaries scripts/build-wiki-content.mjs.
Raw workflow/rule listings content/raw/ landing pages and raw artifact mounts when available.
Public HTML Hugo build output; never hand-edited.

Hygiene checklist#

  1. Every navigable page has title, summary, and weight.
  2. Every generated page has the generator notice.
  3. No public page dumps hidden state, logs, sessions, DBs, or secrets.
  4. Build and secret scan pass before deploy.
  5. Deployment uses npm run wiki:deploy after clean build.

Sources: approved Moincraft Wiki Overhaul plan.