Architecture Decision Record

Active theme: Light

← dokumenty

Porady o pracy zespołowej nad ADR

Jeśli zastanawiasz się nad używaniem rejestrów decyzji w swoim zespole, oto kilka porad, których nauczyliśmy się, pracując z wieloma zespołami.

Masz okazję poprowadzić współpracowników, rozmawiając wspólnie o tym „dlaczego”, zamiast narzucać „co”. Na przykład rejestry decyzji to sposób, by zespoły myślały mądrzej i lepiej się komunikowały; nie mają wartości, jeśli są tylko wymuszonym papierkowym obowiązkiem wypełnianym po fakcie.

Niektóre zespoły zdecydowanie wolą nazwę „decyzje” od skrótu „ADR”. Gdy zespół używa nazwy katalogu „decisions”, to jakby zapalała się żarówka i zespół zaczyna umieszczać w katalogu więcej informacji, takich jak decyzje dotyczące dostawców, planowania, harmonogramów itd. Wszystkie te rodzaje informacji mogą korzystać z tego samego szablonu. Zakładamy, że ludzie uczą się szybciej ze słowami („decyzje”) niż ze skrótami („ADR”), że chętniej piszą dokumenty robocze, gdy usunie się słowo „rejestr”, a także że niektórzy programiści i niektórzy menedżerowie nie lubią słowa „architektura”.

W teorii niezmienność jest ideałem. W praktyce w naszych zespołach lepiej sprawdziła się zmienność. Wstawiamy nowe informacje do istniejącego ADR, z datą i adnotacją, że informacja pojawiła się po podjęciu decyzji. Takie podejście prowadzi do „żywego dokumentu”, który wszyscy możemy aktualizować. Typowe aktualizacje to informacje, które pojawiają się dzięki nowym członkom zespołu, nowym ofertom, rzeczywistym wynikom naszego korzystania lub zmianom po fakcie po stronie podmiotów trzecich, takim jak możliwości dostawców, plany cenowe, umowy licencyjne itp.