diff --git a/adr/template.md b/adr/template.md index 25696bbe..baf6c9d0 100644 --- a/adr/template.md +++ b/adr/template.md @@ -18,30 +18,9 @@ Technical Story: [description | ticket/issue URL] ## Considered Options -* [option 1] -* [option 2] -* [option 3] -* … - -## 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, …] -* … - -### Negative Consequences - -* [e.g., compromising quality attribute, follow-up decisions required, …] -* … - -## Pros and Cons of the Options - ### [option 1] -[example | description | pointer to more information | …] +[example | description | pointer to more information | …] * Good, because [argument a] * Good, because [argument b] @@ -50,7 +29,7 @@ Chosen option: "[option 1]", because [justification. e.g., only option, which me ### [option 2] -[example | description | pointer to more information | …] +[example | description | pointer to more information | …] * Good, because [argument a] * Good, because [argument b] @@ -59,13 +38,27 @@ Chosen option: "[option 1]", because [justification. e.g., only option, which me ### [option 3] -[example | description | pointer to more information | …] +[example | description | pointer to more information | …] * Good, because [argument a] * Good, because [argument b] * Bad, because [argument c] * … +## Decision Outcome + +"[option 1]" was chosen 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, …] +* … + +### Negative Consequences + +* [e.g., compromising quality attribute, follow-up decisions required, …] +* … + ## Links * [Link type] [Link to ADR]