2022-12-01_001-record-architectural-decisions.md

slug	title	authors	tags
1	1. Record Architecture Decisions		Accepted

Status

Accepted

Context

We are in search for a means to describe our technical architecture.

We prefer light-weight documentation methods which accomodate change easily.

The Hydra team has had success with the solution described below. See the Hydra ADR 1.

Decision

• We will use Architecture Decision Records, as described by Michael Nygard in this article.
• We will follow the convention of storing those ADRs as Markdown formatted documents stored under docs/adr directory, as exemplified in Nat Pryce's adr-tools. This does not imply we will be using adr-tools itself.

Consequences

See Michael Nygard's article, linked above.