ADR

То, что очевидно для вас, не очевидно для других.

Максим Батырев — «45 татуировок менеджера»

Communication Engineering · ADR

Правило

Сохраняй причины решения до того, как команда забудет доступные тогда ограничения.

Проблема

Будущая команда видит странное решение, но не знает, какие альтернативы, ограничения и риски существовали.

Запись

• статус и дата;
• контекст;
• решение;
• положительные и отрицательные последствия;
• альтернативы;
• условие пересмотра;
• ссылки на RFC и реализацию.

Жизненный цикл

Не переписывайте историю. Устаревший ADR помечается superseded и связывается с новым.

Не применять

Не создавайте ADR для каждой локальной строки кода. Записывайте решения, цена повторного обсуждения которых выше цены документа.

См. шаблон ADR.