Navigation Inventory And Page Status

Navigation Inventory And Page Status

This page tracks what the wiki exposes as primary navigation, what MkDocs exposes for the repo mirror, and what pages are intentionally archive, machine-facing or hidden from daily reading.

Use it before adding pages to Home, _Sidebar.md, mkdocs.yml, llms.txt or _Footer.md.

Current Snapshot

Snapshot generated from docs/wiki/*.md, _Sidebar.md and mkdocs.yml on 2026-06-05.

Item	Count	Meaning
Markdown pages	140	All .md pages in docs/wiki, including _Sidebar.md and _Footer.md.
Content pages	138	Markdown pages excluding _Sidebar.md and _Footer.md.
Sidebar pages	109	Pages linked from the GitHub wiki sidebar.
MkDocs pages	118	Pages listed in mkdocs.yml navigation.
Pages in both navs	109	Primary pages visible in both GitHub wiki and MkDocs.
Pages in neither nav	20	Usually archives, instruction pages, old queues, analysis notes or narrow patch pages reached through canonical pages.
Sidebar-only pages	0	The 2026-06-05 MkDocs parity pass added the remaining primary sidebar pages to repo mirror navigation.
MkDocs-only pages	9	All imported Miksuu archive pages.
Pages missing Continue Reading	0	All content pages now expose either owner-page or archive/queue-safe routing.
Imported Miksuu archive pages	9	Historical provenance; route through Miksuu upstream wiki import.

Page Status Rules

Status	Use when	Navigation rule
primary	Page is a daily entrypoint or canonical owner page.	Link from sidebar and usually MkDocs.
gateway	Page routes a family of owner pages without owning much source evidence.	Link from sidebar if it reduces clicking friction; keep short.
archive	Historical provenance, imported wiki content or long chronology.	Route through an index page; do not list every archive in the sidebar.
machine	JSON/JSONL or huge agent-state material.	Link from status/agent pages, not broad human nav.
patch-ready	Narrow source-backed implementation handoff.	Link from Feature Status, hardening/backlog pages and the owning subsystem.
hidden-support	Useful page but not a normal reading starting point.	Keep discoverable through related owner pages and search.

Current Drift Buckets

Sidebar-Only Pages

The sidebar-only primary-page drift is closed as of the 2026-06-05 MkDocs parity pass.

Page	Suggested status	Next action
Dead/stale code register	primary	Added to MkDocs UI/tooling quality nav on 2026-06-05.
Headless client scaling and topology	primary	Added to MkDocs Gameplay AI/HC nav on 2026-06-05.
PR cleanup and integration lab	primary while PR triage is active	Added to MkDocs Community & Dev nav on 2026-06-05.
Wiki pruning and relevance ledger	primary for docs owners	Added to MkDocs Agent Coordination nav on 2026-06-05.

MkDocs-Only Pages

These are all imported Miksuu archive pages. Keeping them MkDocs-visible is useful for search, but GitHub wiki users should normally enter through Miksuu upstream wiki import and Community & Dev.

Page family	Suggested status	Next action
Miksuu-Wiki-Archive-*	archive	Keep grouped under the MkDocs Community & Dev archive section; do not re-add every archive page to the sidebar.

Neither-Nav Pages

These pages are not directly listed in either _Sidebar.md or mkdocs.yml. That is acceptable for narrow patch pages and historical queues, but owner pages should have at least one clear inbound route from a canonical page.

Family	Pages	Suggested action
Patch-ready performance/source-fix pages	Client skill init, Factory queue cleanup, Hosted server FPS loop sleep, Supply mission scan narrowing, WASP marker wait cleanup, Paratrooper marker revival, Town AI vehicle safety	Keep out of primary nav if Feature Status, Performance sweep and Testing workflow route to them.
Evidence archives and queues	Deep-review findings, External research reports, Audit findings queue, Development lessons, Subagent discovery swarm	Keep as archive/support pages; expose compact owner routes first.
Broad owner/reference pages	Core systems index, Modules atlas, Server gameplay runtime atlas, Performance opportunity sweep, Player AI caps and role balance, Variable and naming conventions, Arma 2 OA external reference guide	Promoted to both sidebar and MkDocs on 2026-06-05 because they are current owner/reference pages already used by Home and agent-context.json.
Claude/instruction pages	Claude goal, Claude long-term goal, Claude loop goal, Instructions for Codex	Keep discoverable through coordination pages; avoid primary human nav unless actively used.
Analysis/support pages	Client UI and server loop perf findings, External Arma 2 OA reference index, Performance gain simulation, Self-host testing field notes	Keep linked from the owning subsystem or archive index only.

Continue Reading Gaps

Every content page has a ## Continue Reading block as of the 2026-06-05 archive/queue closeout pass.

Family	Pages missing block	Decision
High-traffic owner pages	AI assistant guide, Architecture overview, Mission parameters/localization/build inputs, Player join/disconnect lifecycle, Support specials, Towns/camps/capture, Upgrades/research, Upstream Miksuu commit intel, Marker cleanup/restoration, PR cleanup lab	Completed on 2026-06-05. These now have normalized ## Continue Reading blocks.
Archive/queue pages	Audit findings queue, Development lessons, all Miksuu-Wiki-Archive-* pages	Completed on 2026-06-05. Queue pages route back to owning indexes; imported archive pages keep an archive-chain caveat.

Maintenance Checklist

1. Add a page to exactly one obvious owner family before linking it broadly.
2. If the page is archive or machine material, link it from an index instead of the sidebar.
3. If a page becomes a primary owner page, add it to _Sidebar.md, mkdocs.yml, Home or the relevant gateway page.
4. Update Wiki pruning and relevance ledger when demoting, merging or archiving pages.
5. Run docs/validate-wiki.ps1 after link changes.

Continue Reading

Previous: Wiki pruning and relevance ledger | Next: Knowledge platform roadmap

Main map: Home | Status: Progress dashboard | Agent file: agent-context.json