Pathwise

Manuals / Documentation Systems / Chapter 4

B · Decisions · intermediate · Week 2 · Chapter 4 of 9

ADRs — Architecture Decision Records

Capture context, decision, consequences. Future humans stop re-litigating the past.

Path progress
44%

Step 1 of 1

Write an ADR

Write an ADRDrag stickies · tap for tips
Study mapDrag stickies · tap for tipsKeep it shortdrag · tap →Name the waitdrag · tap →Scope locatorsdrag · tap →Trace when stuckdrag · tap →One browser firstdrag · tap →Isolate statedrag · tap →Assert the UIdrag · tap →Retry wiselydrag · tap →Seed datadrag · tap →Close the loopdrag · tap →Keep it shortdrag · tap →Name the waitdrag · tap →Scope locatorsdrag · tap →Trace when stuckdrag · tap →One browser firstdrag · tap →Isolate statedrag · tap →Pathwise hackdrag · tap →Write an ADRdrag · tap →Try thisdrag · tap →Follow the dashed drag · tap →

Example

# ADR-001: Title
Date / Status: accepted
Context:
Decision:
Consequences:
Alternatives considered:

Do this now

Document one real past decision (even retroactively).

Was this step clear?
Chapter learning outcomes
  • ADR format
  • When to write
  • Superseding

Clear these before you leave