Definition: ADR = Architecture Decision Record, a short document recording an important architectural decision and the reasoning behind it.
It helps future developers understand not only what was chosen, but why it was chosen.
Examples:
- Decision: Use PostgreSQL instead of MongoDB. Reason: Strong relational transactions are required.
- Decision: Use Kafka for asynchronous communication.
- Decision: Use microservices instead of a monolith for a particular large-scale system.