📋 Technical Documentation Types
4 exercise sets. RFC design docs, runbooks, blameless post-mortems, and ADRs — the documents every engineer writes but nobody teaches.
Advanced
RFC & Design Documents
Structure a Request for Comments — background, proposal, alternatives considered, trade-offs, and open questions. The vocabulary that builds technical consensus.
Intermediate
Runbook & Operational Procedures
Write step-by-step operational procedures that someone can follow at 3am. Clear action verbs, preconditions, expected outcomes, and rollback steps.
Intermediate
Blameless Post-Mortem Writing
Write a blameless post-mortem after an incident: impact statement, timeline, root cause, contributing factors, and action items with owners.
Advanced
Architecture Decision Records (ADRs)
Document architectural decisions using the ADR format: context, decision, status, and consequences. The vocabulary for capturing why, not just what.