B · DecisionsIntermediate35 min read
4. ADRs — Architecture Decision Records
Documentation Systems · 36 pages source format
Capture context, decision, consequences. Future humans stop re-litigating the past.
What you'll learn
- ADR format
- When to write
- Superseding
Write an ADR
# ADR-001: Title
Date / Status: accepted
Context:
Decision:
Consequences:
Alternatives considered:Do this now
Document one real past decision (even retroactively).
Clear?