đź“ťArchitecture Decision Record
Architecture Decision Record is a method of documenting important (architectural) decisions.
Some of important sections:
- status
proposed/accepted/rejected/deprecated/superseded
- deciders
everyone involved in the decision
- date
date decision is started/reached
- context/problem statement
what is the issue we’re trying to solve, what is our organizational situation
- constraints
additional factors that influence the decision
- positions/alternatives
options you have considered
- argument
why you selected an alternative
- decision
the change we’re proposing and/or doing
- consequences/implications
what becomes easier or more difficult after this change
References
See also
Lightweight RFC-like process—similar in spirit but covers organizational stuff
Maintain a decision todo list—a list of pending ADRs