Skip to content
Docs-as-Code Primer
Esc
navigateopen⌘Jpreview
On this page

Learning path

Work through these in order if you are learning.

Learning path

Work through these in order if you are learning.

If you are adopting today: follow FIRST_WEEK.md (copy scaffold + minimum files), keep appendix/phase-folder-map.md as the path SSoT, then read primer chapters as you fill each phase.

Core (required)

Read these before anything else.

  1. What Docs as Code means
  2. Two audiences
  3. Content governance

Lifecycle chapters

One chapter per phase, in order. Read alongside the phase you are filling.

  1. Phase 0 — Charter
  2. Phase 1 — Requirements
  3. Phase 2 — Architecture
  4. Phase 3 — Detailed design
  5. Phase 4 — Implementation docs
  6. Phase 5 — Testing
  7. Phase 6 — Operations
  8. Phase 7 — User docs
  9. Phase 8 — Maintenance
  10. Phase 9 — Retirement

Practice layers

Cross-cutting topics that apply across phases. Read in any order after Core.

Then use the kit

Suggested timeboxes

Goal Effort
Understand the model 40–60 minutes (core + phases overview)
First week pack on a greenfield repo ~1 week calendar / few focused hours
Copy scaffold only ≤ 30 minutes
Fill Phase 0–2 for a real project 1–3 days (team dependent)
Enable optional Spectral + one publishing recipe half a day

Was this page helpful?