Architecture Decision Records (ADRs) — Roadmap Step & Resources
Writing lightweight, durable records of significant architectural decisions and their rationale
- Level: beginner
- Estimated time: 1 days
- Roadmap: System Architecture
Before this step
Mini projects
- Write an ADR justifying a choice between REST and gRPC for an internal service
Interview questions
- What should an ADR capture that a Slack message or meeting notes usually miss?
Study resources
- Documenting Architecture Decisions (Article) — Michael Nygard's original, widely-cited blog post that introduced the ADR concept.
- Architecture Decision Records Explained (Video) — A practical explanation of writing and maintaining ADRs on a real team.
Part of
- Documenting & Communicating Architecture — section
- System Architecture roadmap — the full learning path