75 lines
1.8 KiB
Markdown
75 lines
1.8 KiB
Markdown
# ADR-{number}: {Short title of solved problem and solution}
|
|
|
|
Date: {YYYY-MM-DD}
|
|
Status: {Proposed | Accepted | Deprecated | Superseded}
|
|
Deciders: {List everyone involved in the decision}
|
|
Related: {Links to related ADRs, Oracle entries, Summoner MCDs}
|
|
|
|
## Context and Problem Statement
|
|
|
|
{Describe the context and problem statement, e.g., in free form using two to three sentences. You may want to articulate the problem in form of a question.}
|
|
|
|
## Decision Drivers
|
|
|
|
* {decision driver 1, e.g., a force, facing concern, ...}
|
|
* {decision driver 2, e.g., a force, facing concern, ...}
|
|
* {etc.}
|
|
|
|
## Considered Options
|
|
|
|
* {option 1}
|
|
* {option 2}
|
|
* {option 3}
|
|
* {etc.}
|
|
|
|
## Decision Outcome
|
|
|
|
Chosen option: "{option 1}", because {justification. e.g., only option, which meets k.o. criterion decision driver | which resolves force {force} | ... | comes out best (see below)}.
|
|
|
|
### Positive Consequences
|
|
|
|
* {e.g., improvement of quality attribute satisfaction, follow-up decisions required, ...}
|
|
* {etc.}
|
|
|
|
### Negative Consequences
|
|
|
|
* {e.g., compromising quality attribute, follow-up decisions required, ...}
|
|
* {etc.}
|
|
|
|
## Pros and Cons of the Options
|
|
|
|
### {option 1}
|
|
|
|
{example | description | pointer to more information | ...}
|
|
|
|
* Good, because {argument a}
|
|
* Good, because {argument b}
|
|
* Bad, because {argument c}
|
|
* {etc.}
|
|
|
|
### {option 2}
|
|
|
|
{example | description | pointer to more information | ...}
|
|
|
|
* Good, because {argument a}
|
|
* Good, because {argument b}
|
|
* Bad, because {argument c}
|
|
* {etc.}
|
|
|
|
### {option 3}
|
|
|
|
{example | description | pointer to more information | ...}
|
|
|
|
* Good, because {argument a}
|
|
* Good, because {argument b}
|
|
* Bad, because {argument c}
|
|
* {etc.}
|
|
|
|
## Links
|
|
|
|
* {Link to related Oracle knowledge entries}
|
|
* {Link to Summoner Mission Control Documents}
|
|
* {Link to code references}
|
|
* {Link to related ADRs}
|
|
* {External references}
|