brandon/oam
1
0
Fork 0
mirror of https://gitea.com/mcereda/oam.git synced 2026-02-08 21:34:25 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
oam/knowledge base/adr.md
Michele Cereda e2d469a1bf chore(kb/adr): extend article a bit from sources
2026-01-27 18:56:46 +01:00

1.8 KiB
Raw Permalink Blame History

Architectural decision records

Architectural Decisions (ADs) are justified design choices, addressing functional or non-functional requirements that are architecturally significant.

Architecturally Significant Requirements (ASRs) are requirements that has a measurable effect on the architecture, and quality of a software and/or hardware system.

Architectural Decision Records (ADRs) capture a single AD and its rationale.
ADR are meant to help one understand the reasons for a chosen architectural decision, along with its trade-offs and consequences.

The collection of ADRs that are 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).

Warning

FIXME: extend

  1. Further readings

Further readings