Per Phase 1 audit at cowork/docs-overhaul-phase-1-audit-2026-05-04/.
The placeholder from Phase 1 (commit cda957f) gets replaced with the
audience-organized navigation index operators use to find what they
need.
Structure follows the recommended Phase 2 directory tree:
- Getting Started (5 entries)
- Reference — architecture, API, MCP, hierarchy, deployment model,
vendor matrix, plus subsections for connectors (6 pages) and
protocols (7 docs)
- Operator (5 entries + 3 runbooks)
- Migration (6 entries — 3 from-X plus 3 ACME walkthroughs)
- Compliance (index + 3 frameworks)
- Contributor (4 entries)
- Archive (2 version-specific upgrade guides)
Every link verified to resolve to an existing file. Reading-order-by-role
section at the bottom suggests sequencing with rough time-to-complete:
- First-time operator: ~90 minutes
- Production operator: ~4 hours
- PKI engineer: ~6 hours
- Auditor / compliance: ~4 hours
- Contributor: ~3 hours
Future Phase 4 follow-on commits (per-connector page extraction) and
Phase 5 (testing-guide.md prune) will add new entries to this index
as their destination docs land.
Per Phase 1 audit at cowork/docs-overhaul-phase-1-audit-2026-05-04/.
Phase 2 organizes docs/ into eight audience-aligned subdirectories
(getting-started, reference, operator, migration, compliance,
contributor, archive). docs/README.md will be the navigation index
linking into each.
This commit only adds the placeholder. Subdirectories materialize as
Phase 2 file moves land. Index gets populated in Phase 12 once all
moves and content edits are complete.
Audit folder: cowork/docs-overhaul-phase-1-audit-2026-05-04/
Phase 2 prompt: cowork/docs-overhaul-phase-2-restructure-prompt.md
shankar0123