Architecture decision records
On This Lesson 4 topics
This lesson is planned. The outline below lists the topics it will cover. The full lesson has not been published yet.
In this lesson
capture a decision so it can be understood later.
Planned topics
- An ADR is a short, numbered record of one significant decision.
- Sections: title, status, context, options considered, decision, consequences.
- Write it when deciding, with the real alternatives; written afterwards it becomes justification.
- Status: proposed, accepted, superseded by ADR-nnn. Never delete; supersede.
- Include the trade-off accepted and a review trigger or date.
Draft outline details
Demonstration
ADR-007 "Use Kafka for order events" with options (outbox + Kafka, RabbitMQ, polling), decision, and consequences.
Check your understanding
Why list the rejected options?
Show answer
So readers see the decision was weighed and can revisit it when conditions change.
Practice
Apply this lesson with the module's lab, exercises and quiz.
Marking a lesson complete is optional and you can undo it any time. Your progress stays in this browser.