Architecture decision record (ADR)

Версия 5.7 от Alexandr Fokin на 2024/11/23 21:13

ADR, Architecture decision record, Decision log, Реестр архитектурных решений

Отличительные черты:

Описывает информацию о принятии некоторого решения.
Содержит информацию о проблеме, рассматриваем вариантах решения, плюсах и минус каждого варианта.
На основании каких факторов был выбран определенный вариант.
Определить уровень масштаба вопроса - определение ситуаций, для которых необходимо создать запись.
Append-Only - записи создаются в момент принятия решения, сохраняются и в целом не предназначены для изменений.

Ссылки

DotNetRu | Кулаков, Кугушев, Акуляков, Мерсон, Данилов «Круглый стол: Документируй это полностью»
https://www.youtube.com/watch?v=94cJU14qkis

adr/madr https://github.com/adr/madr
endjin / dotnet-adr https://github.com/endjin/dotnet-adr