Architecture Decision Record

Active theme: Light

← документи

Поради щодо командної роботи для ADR

Якщо ви розглядаєте можливість використання записів рішень у своїй команді, ось поради, які ми засвоїли, працюючи з багатьма командами.

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

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

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