Architecture Decision Records

Date: 2018-01-22

Scope

software development

Status

Accepted

Context

Much documentation can be replaced with highly readable code and tests. In a world of evolutionary architecture, however, it's important to record certain design decisions for the benefit of future team members as well as for external oversight. Lightweight Architecture Decision Records is a technique for capturing important architectural decisions along with their context and consequences. We recommend storing these details in source control, instead of a wiki or website, as then they can provide a record that remains in sync with the code itself.

Decision

We will use Architecture Decision Records, as described by Michael Nygard in this article

Consequences

See Michael Nygard's article, linked above.