Skip to content

docs: drop phantom mkdocs nav after Church/State split - #96

Merged
fuzzywigg merged 1 commit into
mainfrom
cursor/honest-mkdocs-nav-b2c8
Sep 26, 2026
Merged

fuzzywigg merged 1 commit into
mainfrom
cursor/honest-mkdocs-nav-b2c8

Conversation

@fuzzywigg

Copy link
Copy Markdown
Owner

Summary

TOKENMAXX ON-20260926 useful-work-only tip residual (post-#95). Not Cloud Run revision SHA lag; not WIF/deploy HITL.

mkdocs.yml nav still pointed at docs removed in 030e086 (Church/State split) plus a Song Library path that only exists under public/:

  • planning/ROADMAP.md — deleted
  • planning/PATHWAY.md — deleted
  • planning/GAP_ASSESSMENT.md — deleted
  • songs.html — not under docs/ (lives at public/songs.html)

Non-strict mkdocs gh-deploy silently ships broken nav. This PR drops those four phantom entries so nav matches the live docs/ tree.

Changes

  • mkdocs.yml — remove phantom Planning/Resources nav entries only

Related Issues

Owner: CoS ON-20260926 (useful-work-only leftover). Expiry: 2026-09-26 America/New_York.

Testing

# Before: 4 nav warnings for missing files
test ! -e docs/planning/ROADMAP.md
test ! -e docs/planning/PATHWAY.md
test ! -e docs/planning/GAP_ASSESSMENT.md
test ! -e docs/songs.html

# After: those nav refs gone; mkdocs no longer warns about them
rg -n 'planning/ROADMAP|planning/PATHWAY|planning/GAP_ASSESSMENT|songs\.html' mkdocs.yml
# expect no matches
mkdocs build --strict 2>&1 | rg 'planning/|songs\.html' || true
# expect no matches for those four

Evidence: tip residual scoped to docs/CI honesty vs live tree. Hard stops honored (no promote/WIF/live deploy; no product invent; no Dependabot #81/#82; no force-push).

Checklist

  • Docs/CI honesty only — no deploy path / WIF / Cloud Run SHA changes
  • No secrets committed
  • Single logical residual fixed
Open in Web Open in Cursor 

mkdocs.yml still linked planning/ROADMAP.md, PATHWAY.md, GAP_ASSESSMENT.md
(deleted in 030e086) and docs/songs.html (lives under public/ only).
Nav now matches the live docs/ tree; no product invent, no deploy/WIF changes.

Co-authored-by: Andrew Pappas <fuzzywigg@users.noreply.github.com>
@fuzzywigg
fuzzywigg marked this pull request as ready for review September 26, 2026 10:28
@fuzzywigg
fuzzywigg merged commit 8c10a9f into main Sep 26, 2026
7 checks passed
@fuzzywigg
fuzzywigg deleted the cursor/honest-mkdocs-nav-b2c8 branch September 26, 2026 10:28
fuzzywigg added a commit that referenced this pull request Sep 26, 2026
TOKENMAXX ON-20260926 tip residual post-#96. docs/index.md still linked
reports/night_ops_2026_01_21.md and reports/incident_jan_17.md removed in
the Church/State split; mkdocs --strict warned on both. Keep Gap Analysis
and Prompt Audit entries that still exist under docs/.

Hard stops: no WIF/deploy/Dependabot; not SHA-only tip-lag.

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Andrew Pappas <fuzzywigg@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants