Советы по командной работе с ADR

Если вы думаете об использовании записей решений в своей команде, вот несколько советов, которые мы усвоили, работая со многими командами.

У вас есть возможность вести за собой коллег, обсуждая вместе «почему», а не предписывая «что». Например, записи решений — это способ для команд думать умнее и лучше общаться; записи решений не имеют ценности, если это просто навязанное задним числом бумажное требование.

Некоторые команды гораздо больше предпочитают название «решения» (decisions) аббревиатуре «ADR». Когда некоторые команды называют каталог «decisions», будто загорается лампочка, и команда начинает класть в каталог больше информации, например решения о поставщиках, решения по планированию, решения по расписанию и т. д. Для всех таких видов информации можно использовать один и тот же шаблон. Мы предполагаем, что люди быстрее учатся на словах («решения»), чем на аббревиатурах («ADR»), что люди охотнее пишут рабочие документы, когда убрано слово «запись», а также что некоторым разработчикам и некоторым руководителям не нравится слово «архитектура».

В теории неизменяемость идеальна. На практике для наших команд лучше работала изменяемость. Мы вставляем новую информацию в существующую ADR с датой и пометкой о том, что информация появилась после принятия решения. Такой подход приводит к «живому документу», который мы все можем обновлять. Типичные обновления происходят, когда мы получаем информацию благодаря новым коллегам, новым предложениям, реальным результатам нашего использования или изменениям у третьих сторон после принятия решения, например возможностям поставщика, тарифным планам, лицензионным соглашениям и т. д.