📝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
- adr/madr: Markdown Architectural Decision Records
- npryce/adr-tools: Command-line tools for working with Architecture Decision Records
See also
- Lightweight RFC-like process—similar in spirit but covers organizational stuff
- Maintain a decision todo list—a list of pending ADRs
- Present ADRs as simply “decisions”
- Be wary of wasting time documenting design decisions
