bigonotes
Engineering PracticesDesign Docs

Design Docs

Plan the work and record the decisions and trade-offs.

2 notes · 10 min total

  1. 1Writing a Design DocWhen to write a design doc, which sections it needs, how to make it easy to review, and how to keep it current.5 min
  2. 2Decision Records and Trade-offsHow to record architecture decisions in ADRs, compare options fairly, and match your process to how reversible a decision is.5 min