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	102	Pages linked from the GitHub wiki sidebar.
MkDocs pages	107	Pages listed in mkdocs.yml navigation.
Pages in both navs	98	Primary pages visible in both GitHub wiki and MkDocs.
Pages in neither nav	27	Usually owner pages, archives, old queues or narrow patch pages reached through canonical pages.
Sidebar-only pages	4	Visible in GitHub wiki but not MkDocs.
MkDocs-only pages	9	All imported Miksuu archive pages.
Pages missing Continue Reading	11	Archive/queue pages only after the 2026-06-05 owner-page polish pass.
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

These pages are visible in the GitHub wiki sidebar but not in MkDocs navigation.

Page	Suggested status	Next action
Dead/stale code register	primary	Add to MkDocs quality/operations nav or intentionally mark MkDocs as slimmer than the wiki.
Headless client scaling and topology	primary	Add under gameplay/AI in MkDocs or route only through AI/HC pages.
PR cleanup and integration lab	primary while PR triage is active	Add to MkDocs status/coordination nav while PR cleanup is live.
Wiki pruning and relevance ledger	primary for docs owners	Add to MkDocs quality/coordination nav or keep GitHub-wiki-only for maintenance.

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 pages currently hidden	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	Consider adding these to MkDocs/sidebar if they remain current owner pages.
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

Home should not claim every content page has previous/next links until these are resolved or intentionally waived.

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	Remaining gap. Either add archive-specific footer links or explicitly waive the chain for archive pages.

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