Topic
Design docs and decisions
Guides to software design documents and architecture decision records: what to put in them, how to review them, and how to keep the reasoning attached to the change.
All posts
Latest writing
- How to write a software design document: outline, examples and review checklistA section-by-section guide to writing a software design document, with what good content looks like, what people leave out, and a checklist for reviewing one.Design docs and decisions
8 min read - Architecture decision records, a practical guideHow to write architecture decision records your team will actually maintain, with a copyable template and a worked example for your repo.Design docs and decisions
11 min read
Start
Try what we write about
No credit card required