Журнал Архитектурных Решений (ADR)¶

В этом журнале хранятся совместно принятые архитектурные решения (далее AD) принятых по установленному процессу.

Архитектурне решение оформляется в виде Записки (ADR) по установленному шаблону.

Соглашение принимается и рассматривается через PR к этому репозиторию и считается принятым всеми сторонами подписывашими PR в роли Reviewer.

Зачем это?¶

Повысить качество принимаемых решений:
Более тщательнее находятся варианты решений, плюсы и минусы.
Решения принимаются на объективной основе взвешивания факторов, а не личного авторитета.
Снизить ошибочные представления участников за счет визуальной фиксации предлагаемых вариантов.
Иметь возможность ссылаться на решение из кода и в переписке для понимания причинно-следственной связи.
Для возможности пересмотра решения в случае изменения обстоятельств или потому-то "забыли почему так".
Упрощение приземления новых участников команды.