Когда работа над сложной системой идёт пару лет, очень важно иметь возможность вспомнить, почему полгода назад мы сделали X, а не Y. Для этого мы заводим специальные странички во внутренней вики по проекту, куда записываем проблему, принятые решения, их обоснование и связанные риски. Постепенно таких записей накапливается довольно много, устаревшие перемещаются в соответствующий раздел.
Post #793
1.52K


Одна из самых полезных практик для команды контрактной (вообще-то для любой) разработки — это т.н. ADR , американские депозитарные расписки, Architecture Decision Record. Термин пришел из разработки софта, в нашей работе мы называем так фиксацию контекста по принятым решениям.
Когда работа над сложной системой идёт пару лет, очень важно иметь возможность вспомнить, почему полгода назад мы сделали X, а не Y. Для этого мы заводим специальные странички во внутренней вики по проекту, куда записываем проблему, принятые решения, их обоснование и связанные риски. Постепенно таких записей накапливается довольно много, устаревшие перемещаются в соответствующий раздел.
Когда работа над сложной системой идёт пару лет, очень важно иметь возможность вспомнить, почему полгода назад мы сделали X, а не Y. Для этого мы заводим специальные странички во внутренней вики по проекту, куда записываем проблему, принятые решения, их обоснование и связанные риски. Постепенно таких записей накапливается довольно много, устаревшие перемещаются в соответствующий раздел.
- 👍 26
- ❤ 2
- ❤🔥 1