Architecture Decision Record

Active theme: Light

← dokumenty

Rady k tímovej práci pre ADR

Ak uvažujete o používaní záznamov rozhodnutí vo svojom tíme, tu je niekoľko rád, ktoré sme sa naučili pri práci s mnohými tímami.

Máte príležitosť viesť svojich spolupracovníkov tým, že sa spolu budete rozprávať o tom „prečo“, namiesto nariaďovania toho „čo“. Napríklad záznamy rozhodnutí sú spôsob, ako môžu tímy múdrejšie rozmýšľať a lepšie komunikovať; záznamy rozhodnutí nemajú hodnotu, ak sú len dodatočne vynútenou papierovou požiadavkou.

Niektoré tímy oveľa viac uprednostňujú názov „rozhodnutia“ pred skratkou „ADR“. Keď niektoré tímy použijú názov adresára „decisions“, je to, ako keby sa rozsvietila žiarovka a tím začne do adresára dávať viac informácií, napríklad rozhodnutia o dodávateľoch, rozhodnutia o plánovaní, rozhodnutia o harmonogramoch atď. Všetky tieto druhy informácií môžu používať rovnakú šablónu. Predpokladáme, že sa ľudia učia rýchlejšie so slovami („rozhodnutia“) než so skratkami („ADR“), že ľudia sú motivovanejší písať dokumenty o rozpracovanej práci, keď sa slovo „záznam“ odstráni, a tiež že niektorým vývojárom a niektorým manažérom sa slovo „architektúra“ nepáči.

Teoreticky je nemennosť ideálna. V praxi sa našim tímom lepšie osvedčila meniteľnosť. Nové informácie vkladáme do existujúceho ADR s dátumovou pečiatkou a poznámkou, že informácie prišli po rozhodnutí. Tento druh prístupu vedie k „živému dokumentu“, ktorý môžeme všetci aktualizovať. Typické aktualizácie nastávajú, keď získame informácie vďaka novým spolupracovníkom, novým ponukám alebo skutočným výsledkom nášho používania, alebo po dodatočných zmenách tretích strán, ako sú schopnosti dodávateľov, cenové plány, licenčné zmluvy atď.