Initial commit

docs/docs/reference/decisions/architecture-decision.tmpl

@@ -0,0 +1,64 @@
+# {Title of solution to solve the problem}
+
+## Context and problem statement
+
+{Describe the context and problem in free form, using two to three sentences or in the form of an illustrative story.
+ You may want to articulate the problem in form of a question and add links to collaboration boards or issue management systems.}
+
+<!-- This is an optional element. Feel free to remove. -->
+## Decision Drivers
+
+* {decision driver, e.g., a force, facing concern, ...}
+* ...
+
+## Considered Options
+
+* [{title of option}](#{title of option})
+* ...
+
+## Decision Outcome
+
+Chosen option: "{title of chosen option}", because
+{justification. e.g., only option, which meets k.o. criterion decision driver | which resolves force {force} | … | comes out best (see below)}.
+
+<!-- This is an optional element. Feel free to remove. -->
+## Decision Revisit
+
+Last revisit: {information about the last revisit e.g. never | {date} by {author}}
+
+<!-- This is an optional element. Feel free to remove. -->
+### Consequences
+
+* Good, because {positive consequence, e.g., improvement of one or more desired qualities, …}
+* Bad, because {negative consequence, e.g., compromising one or more desired qualities, …}
+* … <!-- numbers of consequences can vary -->
+
+<!-- This is an optional element. Feel free to remove. -->
+## Validation
+
+{describe how the implementation of/compliance with the ADR is validated. E.g., by a review or an ArchUnit test}
+
+<!-- This is an optional element. Feel free to remove. -->
+## Pros and Cons of the Options
+
+<!-- This is an repeated element per option. use when necessary. -->
+### {title of option}
+
+<!-- This is an optional element. Feel free to remove. -->
+{example | description | pointer to more information | …}
+
+* Good, because {argument a}
+* Good, because {argument b}
+<!-- use "neutral" if the given argument weights neither for good nor bad -->
+* Neutral, because {argument c}
+* Bad, because {argument d}
+* ... <!-- numbers of pros and cons can vary -->
+
+<!-- This is an optional element. Feel free to remove. -->
+## More Information
+
+{Provide additional evidence/confidence for the decision outcome here and/or
+ document the team agreement on the decision and/or
+ define when this decision when and how the decision should be realized and if/when it should be re-visited and/or
+ how the decision is validated.
+ Links to other decisions and resources might here appear as well.}