Markdown ADR template
·
Link:: https://github.com/adr/madr
# [short title of solved problem and solution]
* Status: [proposed | rejected | accepted | deprecated | β¦ | superseded by [ADR-0005](0005-example.md)] <!-- optional -->
* Deciders: [list everyone involved in the decision] <!-- optional -->
* Date: [YYYY-MM-DD when the decision was last updated] <!-- optional -->
Technical Story: [description | ticket/issue URL] <!-- optional -->
## 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 <!-- optional -->
* [driver 1, e.g., a force, facing concern, β¦]
* [driver 2, e.g., a force, facing concern, β¦]
* β¦ <!-- numbers of drivers can vary -->
## Considered Options
* [option 1]
* [option 2]
* [option 3]
* β¦ <!-- numbers of options can vary -->
## 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 <!-- optional -->
* [e.g., improvement of quality attribute satisfaction, follow-up decisions required, β¦]
* β¦
### Negative Consequences <!-- optional -->
* [e.g., compromising quality attribute, follow-up decisions required, β¦]
* β¦
## Pros and Cons of the Options <!-- optional -->
### [option 1]
[example | description | pointer to more information | β¦] <!-- optional -->
* Good, because [argument a]
* Good, because [argument b]
* Bad, because [argument c]
* β¦ <!-- numbers of pros and cons can vary -->
### [option 2]
[example | description | pointer to more information | β¦] <!-- optional -->
* Good, because [argument a]
* Good, because [argument b]
* Bad, because [argument c]
* β¦ <!-- numbers of pros and cons can vary -->
### [option 3]
[example | description | pointer to more information | β¦] <!-- optional -->
* Good, because [argument a]
* Good, because [argument b]
* Bad, because [argument c]
* β¦ <!-- numbers of pros and cons can vary -->
## Links <!-- optional -->
* [Link type] [Link to ADR] <!-- example: Refined by [ADR-0005](0005-example.md) -->
* β¦ <!-- numbers of links can vary -->
ΠΠ°ΠΊΠΈΠ΅ Ρ ΠΌΠ΅Π½Ρ ΠΌΡΡΠ»ΠΈ ΠΏΠΎ ΡΡΠΎΠΌΡ ΠΏΠΎΠ²ΠΎΠ΄Ρ Π² ΠΌΠΎΠΌΠ΅Π½ΡΠ΅?
ΠΡΠΎΡΡΠΎΠΉ ΡΠ°Π±Π»ΠΎΠ½ Π½Π° ΠΎΡΠ½ΠΎΠ²Π΅, ΠΊΠΎΡΠΎΡΠΎΠ³ΠΎ ΠΌΠΎΠΆΠ½ΠΎ ΠΏΡΠΈΠ½ΠΈΠΌΠ°ΡΡ ΡΠ΅ΡΠ΅Π½ΠΈΠ΅ ΠΏΠΎ Π°ΡΡ ΠΈΡΠ΅ΠΊΡΡΡΠ½ΡΠΌ ΠΈΠ·ΠΌΠ΅Π½Π΅Π½ΠΈΡΠΌ.
ΠΠ°ΠΊΠΈΠ΅ ΠΎΡΠΊΡΡΡΡΠ΅ Π²ΠΎΠΏΡΠΎΡΡ ΠΎΡΡΠ°Π»ΠΈΡΡ ΠΏΠΎΡΠ»Π΅ ΠΎΠ±ΡΠ°Π±ΠΎΡΠΊΠΈ?
ΠΠΎΠΆΠ½ΠΎ Π»ΠΈ Π΅Π³ΠΎ ΠΊΠ°ΠΊ-ΡΠΎ ΡΠΏΡΠΎΡΡΠΈΡΡ?
ΠΠ°Π΄ΠΎ Π»ΠΈ ΡΠ²ΡΠ·Π°ΡΡ Ρ ΠΊΠ°ΠΊΠΈΠΌ-ΡΠΎ Π΄ΠΎΡΡΡΠΏΠ½ΡΠΌΠΈ Π·Π°ΠΌΠ΅ΡΠΊΠ°ΠΌΠΈ?
ΠΠΏΠΈΡΠ°ΡΡ Ρ ΡΠ΅Π±Ρ ΠΏΡΠ°ΠΊΡΠΈΠΊΡ ΠΏΡΠΈΠ½ΡΡΠΈΡ Π°ΡΡ ΠΈΡΠ΅ΠΊΡΡΡΠ½ΡΡ ΡΠ΅ΡΠ΅Π½ΠΈΠΉ Ρ ΠΏΠΎΠΌΠΎΡΡΡ Architecture Decision Record.