|
| 1 | +# [short title of solved problem and solution] |
| 2 | + |
| 3 | +* Status: [proposed | rejected | accepted | deprecated | … | superseded by [ADR-0005](0005-example.md)] <!-- optional --> |
| 4 | +* Deciders: [list everyone involved in the decision] <!-- optional --> |
| 5 | +* Date: [YYYY-MM-DD when the decision was last updated] <!-- optional --> |
| 6 | + |
| 7 | +Technical Story: [description | ticket/issue URL] <!-- optional --> |
| 8 | + |
| 9 | +## Context and Problem Statement |
| 10 | + |
| 11 | +[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.] |
| 12 | + |
| 13 | +## Decision Drivers <!-- optional --> |
| 14 | + |
| 15 | +* [driver 1, e.g., a force, facing concern, …] |
| 16 | +* [driver 2, e.g., a force, facing concern, …] |
| 17 | +* … <!-- numbers of drivers can vary --> |
| 18 | + |
| 19 | +## Considered Options |
| 20 | + |
| 21 | +* [option 1] |
| 22 | +* [option 2] |
| 23 | +* [option 3] |
| 24 | +* … <!-- numbers of options can vary --> |
| 25 | + |
| 26 | +## Decision Outcome |
| 27 | + |
| 28 | +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)]. |
| 29 | + |
| 30 | +### Positive Consequences <!-- optional --> |
| 31 | + |
| 32 | +* [e.g., improvement of quality attribute satisfaction, follow-up decisions required, …] |
| 33 | +* … |
| 34 | + |
| 35 | +### Negative Consequences <!-- optional --> |
| 36 | + |
| 37 | +* [e.g., compromising quality attribute, follow-up decisions required, …] |
| 38 | +* … |
| 39 | + |
| 40 | +## Pros and Cons of the Options <!-- optional --> |
| 41 | + |
| 42 | +### [option 1] |
| 43 | + |
| 44 | +[example | description | pointer to more information | …] <!-- optional --> |
| 45 | + |
| 46 | +* Good, because [argument a] |
| 47 | +* Good, because [argument b] |
| 48 | +* Bad, because [argument c] |
| 49 | +* … <!-- numbers of pros and cons can vary --> |
| 50 | + |
| 51 | +### [option 2] |
| 52 | + |
| 53 | +[example | description | pointer to more information | …] <!-- optional --> |
| 54 | + |
| 55 | +* Good, because [argument a] |
| 56 | +* Good, because [argument b] |
| 57 | +* Bad, because [argument c] |
| 58 | +* … <!-- numbers of pros and cons can vary --> |
| 59 | + |
| 60 | +### [option 3] |
| 61 | + |
| 62 | +[example | description | pointer to more information | …] <!-- optional --> |
| 63 | + |
| 64 | +* Good, because [argument a] |
| 65 | +* Good, because [argument b] |
| 66 | +* Bad, because [argument c] |
| 67 | +* … <!-- numbers of pros and cons can vary --> |
| 68 | + |
| 69 | +## Links <!-- optional --> |
| 70 | + |
| 71 | +* [Link type] [Link to ADR] <!-- example: Refined by [ADR-0005](0005-example.md) --> |
| 72 | +* … <!-- numbers of links can vary --> |
0 commit comments