2020-03-14. ARCH Record architecture decisions Detailed Template

Date: 2020-03-14

Status

Amended What is the status, such as Proposed, Rejected, Deprecated, Accepted, Superceded, Amended, Unknown, Pending.

Context

The issue motivatina# [short title of solved problem and solution] What is the issue that we’re seeing that is motivating this decision or change?

• Status: [proposed

  rejected

  accepted

  deprecated

  …

  superseded by ADR-0005]

• Deciders: [list everyone involved in the decision]
• Date: [YYYY-MM-DD when the decision was last updated]

Technical Story: [description

ticket/issue URL]

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

• [driver 1, e.g., a force, facing concern, …]
• [driver 2, e.g., a force, facing concern, …]
• …

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

…]

• Good, because [argument a]
• Good, because [argument b]
• Bad, because [argument c]
• …

[option 2]

[example

description

pointer to more information

…]

• Good, because [argument a]
• Good, because [argument b]
• Bad, because [argument c]
• …

[option 3]

[example

description

pointer to more information

…]

• Good, because [argument a]
• Good, because [argument b]
• Bad, because [argument c]
• …

Links

• [Link type] [Link to ADR]
• … g this decision, and any context that influences or constrains the decision.

Decision

What is the change that we’re proposing and/or doing? The change that we’re proposing or have agreed to implement.

Consequences

What becomes easier or more difficult to do and any risks introduced by the change that will need to be mitigated.