You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Part of the docs overhaul epic #5467. Operator direction 2026-11-17: "I am pretty sure there are huge gaps in our documentation and lots of stuff that is outdated, I want a thorough cleanup and really get documentation into tip top shape."
The feature inventory checked which features have docs, not whether each page is accurate. This issue is a line-by-line accuracy audit of every published page in the Getting Started, Vision and Changelog intro nav group (5 pages) against current main (v0.88 or later).
Read the whole page. List every factual claim: commands and flags, config keys and defaults, UI labels and locations, file paths, behavior, limits, supported harnesses/trackers/platforms, maturity.
Verify each claim against current code (git grep), pan <verb> --help, src/lib/config-yaml/defaults.ts, the dashboard source, and changelog.mdx. Do not trust other docs pages as proof; several are stale.
Fix wrong claims, delete claims about removed features, and add what a user needs that is missing (short; link to the dedicated page instead of duplicating it). Label early, experimental (Settings → Experimental) and testing features as such.
Frontmatter: specific searchable title, description 50 to 160 characters, no em or en dashes in either. Remove em dashes from the body too.
Check every link on the page resolves.
Tick the page above in the PR body with a one-line note of what changed (or "verified, no change").
Every PR for this issue
Run the Mintlify validator (npx mint validate or the current equivalent) and the link check (npx mint broken-links) and paste the clean result in the PR body.
Zero U+2013/U+2014 in titles and descriptions of the touched pages.
Docs-only: no changelog.d entry unless behavior changed.
Found while planning #5468 (issue pipeline page), for the Getting Started audit:
concepts.mdx (Pipeline paragraph and the image alt text) says the Pipeline page groups issues into Ship, Review and Verifying with a Review queue metric. Code: lanes Ship, Review, Work, Plan, Ready (lib/pipeline-state.ts) and the metric Review running (Pipeline/PipelineView.tsx).
Scope note from planning #5480 (quickstart install paths): #5480 rewrites the install sections of quickstart.mdx (npx, install script + overdeck up, requirements, npm/headless, desktop downloads), fixes overdeck work and the 'swap models' claim, adds a Get help section and removes every en/em dash on the page. It keeps 'What happens next' steps 1 to 4, the board paragraph and 'Architecture at a glance' as they are apart from dashes, so the line-by-line audit of those still belongs to this issue.
Accuracy audit of introduction, quickstart, concepts, vision and the changelog intro; recaptured the hero, board and pipeline doc shots. No deviations.
workspace removed; feature branch kept (close_out.delete_feature_branch is off); No tmux sessions or Herdr panes found; No shadow state found; No legacy planning directory found; Stopped Docker containers; No orphaned processes found; No worker worktrees; Removed git worktree; Pruned 4 agent directories (transcripts and state kept); No strike branch strike/pan-5499 found; Pruned 178 checkpoint ref(s) for agent-pan-5499, planning-pan-5499, strike-pan-5499; No specialist registry entries for PAN-5499
Activity
eltmon commentedon Nov 18, 2026
Found while planning #5468 (issue pipeline page), for the Getting Started audit:
concepts.mdx(Pipeline paragraph and the image alt text) says the Pipeline page groups issues into Ship, Review and Verifying with a Review queue metric. Code: lanes Ship, Review, Work, Plan, Ready (lib/pipeline-state.ts) and the metric Review running (Pipeline/PipelineView.tsx).concepts.mdxandintroduction.mdxsay a test agent checks every PR; the test role is not dispatched after review today (Test role is never dispatched after review approval: nothing emits review.approved #5537).docs: issue pipeline, end to end #5468 adds one sentence link and one Next Steps bullet to concepts.mdx and changes nothing else there.
eltmon commentedon Nov 18, 2026
Scope note from planning #5480 (quickstart install paths): #5480 rewrites the install sections of quickstart.mdx (npx, install script + overdeck up, requirements, npm/headless, desktop downloads), fixes
overdeck workand the 'swap models' claim, adds a Get help section and removes every en/em dash on the page. It keeps 'What happens next' steps 1 to 4, the board paragraph and 'Architecture at a glance' as they are apart from dashes, so the line-by-line audit of those still belongs to this issue.eltmon commentedon Nov 19, 2026
🤖 Agent completed work:
Accuracy audit of introduction, quickstart, concepts, vision and the changelog intro; recaptured the hero, board and pipeline doc shots. No deviations.
eltmon commentedon Nov 19, 2026
Closed via close-out ceremony
Definition of Done
Gate: passed