Architectural Decision Records

From https://adr.github.io/:

An Architectural Decision (AD) is a justified design choice that addresses a functional or non-functional requirement that is architecturally significant. An Architecturally Significant Requirement (ASR) is a requirement that has a measurable effect on the architecture and quality of a software and/or hardware system. An Architectural Decision Record (ADR) captures a single AD and its rationale; Put it simply, ADR can help you understand the reasons for a chosen architectural decision, along with its trade-offs and consequences.

The collection of ADRs created and maintained in a project constitute its decision log. All these are within the topic of Architectural Knowledge Management (AKM), but ADR usage can be extended to design and other decisions (“any decision record”).

This document will record and store any ADRs made by the Architecture Working Group on a Decision Log so that they can be consulted and referenced.

References

• https://en.wikipedia.org/wiki/Architectural_decision

• https://adr.github.io/

• https://adr.github.io/madr/

• https://github.com/adr/madr/blob/develop/template/adr-template.md

Decision Log