Architecture Decision Record

Active theme: Light

← документи

Съвети за работа в екип за ADR

Ако обмисляте да използвате записи на решения във вашия екип, ето няколко съвета, които сме научили, работейки с много екипи.

Имате възможност да поведете съекипниците си, като обсъждате заедно „защо“, вместо да налагате „какво“. Например записите на решения са начин екипите да мислят по-умно и да общуват по-добре; записите на решения нямат стойност, ако са просто изискване за принудителна документация постфактум.

Някои екипи предпочитат много повече името „решения“ пред съкращението „ADR“. Когато някои екипи използват името на директорията „decisions“, сякаш се включва крушка и екипът започва да слага повече информация в директорията, като решения за доставчици, решения за планиране, решения за графици и т.н. Всички тези видове информация могат да използват един и същ шаблон. Предполагаме, че хората учат по-бързо с думи („решения“), отколкото със съкращения („ADR“), и че хората са по-мотивирани да пишат документи за работа в процес, когато думата „запис“ е премахната, а също така някои разработчици и някои мениджъри не харесват думата „архитектура“.

На теория неизменимостта е идеална. На практика изменимостта работи по-добре за нашите екипи. Вмъкваме новата информация в съществуващия ADR, с дата и бележка, че информацията е пристигнала след решението. Този вид подход води до „жив документ“, който всички можем да актуализираме. Типични актуализации са, когато получаваме информация благодарение на нови съекипници, нови предложения или реални резултати от употребата ни, или след промени от трети страни постфактум, като възможности на доставчици, ценови планове, лицензионни споразумения и т.н.