Context
The problem, the forces at play, and the constraints that made a decision necessary. What changed, and why now? |
Decision
What we decided, stated plainly in one or two sentences.
Consequences
Positive
- What we gain.
Negative / trade-offs
- What we accept in return.
Alternatives considered
The other options weighed, and why each was not chosen.
References
- Real links out: GitHub PRs/commits/issues and external sources. (Links to other ADRs go in the
dependsOn/relatedfrontmatter.)