How-to article
Explain step by step how to do one task.
Record one architecture decision, its context and its consequences.
Status | 🟡 Proposed | 🟢 Accepted | ⚪ Superseded |
Date | |
Deciders | @mention the people who make the decision |
The problem that needs a decision, and the facts and limits that affect it, for example the budget, the skills of the team or a deadline.
The decision in one or two sentences, in the active voice: "We will …".
Why you chose this option over the others.
Option | Pros | Cons |
|---|---|---|
An option that you considered, including the one you chose | What is good about it | What is bad about it |
✅ Good
⚠️ Bad
Do not change an accepted record. To change the decision, write a new record, link the two records, and set the status of this one to Superseded.