То, что очевидно для вас, не очевидно для других.
Проблема
Будущая команда видит странное решение, но не знает, какие альтернативы, ограничения и риски существовали.
Запись
- статус и дата;
- контекст;
- решение;
- положительные и отрицательные последствия;
- альтернативы;
- условие пересмотра;
- ссылки на RFC и реализацию.
Жизненный цикл
Не переписывайте историю. Устаревший ADR помечается superseded и связывается с
новым.
Не применять
Не создавайте ADR для каждой локальной строки кода. Записывайте решения, цена повторного обсуждения которых выше цены документа.
См. шаблон ADR.
