Skip to content

Navigation Inventory And Page Status

rayswaynl edited this page Jun 23, 2026 · 14 revisions

Navigation Inventory And Page Status

This page tracks what the GitHub wiki exposes as primary navigation, what the repo mirror exposes when it is current, 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 a fresh GitHub wiki checkout rebased over origin/master@d2bad96 on 2026-06-23. The older local wiki checkout C:\Users\Steff\a2wasp-wiki is dirty and behind origin/master; the older repo mirror C:\Users\Steff\a2waspwarfare-docs\docs\wiki is dirty and has only 93 Markdown files. Do not treat either dirty checkout as a parity source until its uncommitted work is preserved.

Item Count Meaning
Markdown pages 275 All .md pages in the live wiki checkout, including _Sidebar.md and _Footer.md.
Content pages 273 Markdown pages excluding _Sidebar.md and _Footer.md; this matches the GitHub wiki page count shown on Home.
Sidebar link refs 242 Total local wiki links in _Sidebar.md after removing duplicate cross-family refs.
Sidebar unique targets 242 Unique sidebar targets. This includes llms.txt and agent-machine-index.json.
Content pages in sidebar 240 Markdown content pages linked from _Sidebar.md.
Pages not in sidebar 33 Usually archives, instruction pages, narrow patch pages or support pages reached through canonical owner pages.
Footer unique targets 58 Shared footer links in _Footer.md after the footer support-page prune.
Pages not in sidebar or footer 32 Support/archive pages that should stay reachable from owner pages rather than broad persistent navigation.
Home unique targets 183 Local wiki targets linked from Home, excluding repeated route-table refs.
Duplicate sidebar targets 0 The duplicate Player vehicle/travel actions and QoL trio player hints content/reference refs were removed; the UI/player workflow refs remain.
Broken local links 0 Broad local Markdown link pass across .md pages found no missing wiki/file targets.
MkDocs entries Not current No current mkdocs.yml was present in this live wiki checkout, and the older repo mirror is not in parity. Refresh after mirror sync.
Pages missing Continue Reading 0 This batch found and fixed the two AI Commander B69 pages that were missing footer 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 live sidebar intentionally exposes two non-Markdown files for agent entry: llms.txt and agent-machine-index.json. Primary Markdown sidebar-only drift cannot be compared to MkDocs until the repo mirror is synced again.

Page Suggested status Next action
llms.txt agent-entry Keep in sidebar and Home agent routes.
agent-machine-index.json machine-file Keep in sidebar for agents; do not promote as a human content page.
Player vehicle/travel actions, QoL trio player hints deduped-player-workflow-link Duplicate content/reference rows removed on 2026-06-23; keep the UI/player workflow rows.

Repo Mirror / MkDocs State

The live GitHub wiki is ahead of the local repo mirror state visible in this workspace. The safe next sync is file-by-file preservation, not a blind copy over either dirty checkout.

Surface Observed state Next action
C:\Users\Steff\a2wasp-wiki Dirty, behind origin/master; many local modified wiki pages plus untracked validate-wiki.ps1. Preserve or branch its uncommitted work before syncing to live wiki.
C:\Users\Steff\a2waspwarfare-docs\docs\wiki Dirty, older repo mirror with 93 Markdown files / 91 content pages. Treat as stale until reconciled against live wiki; do not claim parity.
mkdocs.yml No current file in the live wiki checkout or the visible a2waspwarfare-docs root. Refresh MkDocs counts only after the repo mirror is current again.

Neither-Nav Pages

These pages are not directly listed in _Sidebar.md; 32 of them are also absent from the shared footer. That is mostly intentional: they are linked from owner/status pages, archive indexes or source-fix queues, but should not become first-click navigation unless their role changes.

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, Upstream mining ledger Keep as archive/support pages; expose compact owner routes first.
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.
Imported Miksuu archive pages Miksuu-Wiki-Archive-* pages Keep routed through Miksuu upstream wiki import and Community & Dev, not individual sidebar rows.
Narrow branch/status pages Mission start parameters, Server init bind cleanup, UI resource parity cleanup Keep linked from source/status owner pages unless they become daily owner pages.

Remaining Support-Only Pages

Use this list as the closeout state for neither-nav cleanup. A page should leave this table only when it becomes a primary owner page, a current gateway, or stale enough to merge/archive.

Status Pages Keep reachable through
patch-ready 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 Feature status, Performance opportunity sweep, Testing workflow, Hardening roadmap.
archive / evidence-ledger Deep-review findings, External research reports, Audit findings queue, Development lessons, Subagent discovery swarm Agent worklog, Progress dashboard, Feature status, Wiki pruning ledger.
sidebar-visible archive Agent worklog archive Keep sidebar-visible as the long-form continuation of Agent worklog.
agent-instruction Claude goal, Claude long-term goal, Claude loop goal, Instructions for Codex Coordination board, Agent collaboration protocol, AI assistant developer guide.
analysis-support Client UI/server loop perf findings, External Arma 2 OA reference index, Performance gain simulation, Self-host testing field notes Client UI systems atlas, Arma 2 OA external reference guide, Performance opportunity sweep, Server ops runbook.

Continue Reading Gaps

Every content page has a ## Continue Reading block as of the 2026-06-23 live-count refresh.

Family Pages missing block Decision
AI Commander B69 pages Fixed: AI commander B69 improvement roadmap, AI commander B69 implementation sketches Added owner-route blocks in this batch.
High-traffic owner pages None Previously missing owner-page blocks were normalized on 2026-06-05; live scan is clean again.
Archive/queue pages None 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, Home or the relevant gateway page; add it to mkdocs.yml only after the repo mirror is current again.
  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

Sidebar

Clone this wiki locally