Architecture Decisions#

This chapter records important architectural decisions and their rationale.

Record a decision when it is hard to change later, likely to be debated again, relevant for cost or risk, or necessary to explain a non-obvious implementation choice.

<Decision Area>#

<Decision Question>#

<Description of the architectural choice, what makes it architecture-relevant and what the consequences are>

Considered alternatives:

  1. <alternative>

  2. <alternative>

<Decision Title>#

dsn~<decision-id>~1

The system <decision statement>.

Rationale:

<Why this alternative fits the requirements and constraints.>

Status: draft

Covers:

  • constr~<constraint-id>~1

Needs: impl

Tags: <tag>

Open Issues#

  • <decision contradiction, undocumented tradeoff, or missing decision>