Architecture decision record (ADR)

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

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

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

Ссылки:

joelparkerhenderson/architecture-decision-record
https://github.com/joelparkerhenderson/architecture-decision-record

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

Реестр архитектурных решений
https://pragmatic-km.guide/practices/knowledge-registration/registration/architecture.html

adr/madr
https://github.com/adr/madr