Architectural Decision Records

Why

1. To make a thorough decision, esp. exploring alternatives
2. To share whenever there is a question from customers or leadership
3. To roadmap on top of earlier decisions

What

• https://adr.github.io/madr/#overview

How

• https://adr.github.io/madr/examples.html

Template

Here are the sections I recommend:

1. Context
2. Problem Statement
3. Solution Options
4. Options Evaluation
5. Conclusion
6. Notes