Architecture Decision Record

Active theme: Light

← dokumenty

Rady k týmové práci pro ADR

Pokud uvažujete o používání záznamů rozhodnutí ve svém týmu, zde je několik rad, které jsme se naučili při práci s mnoha týmy.

Máte příležitost vést své spolupracovníky tím, že společně mluvíte o „proč“, místo abyste nařizovali „co“. Například záznamy rozhodnutí jsou způsob, jak týmy mohou chytřeji myslet a lépe komunikovat; záznamy rozhodnutí nemají hodnotu, pokud jsou jen dodatečným vynuceným papírováním.

Některé týmy mnohem více preferují název „rozhodnutí“ před zkratkou „ADR“. Když některé týmy použijí název adresáře „decisions“, je to, jako by se rozsvítila žárovka, a tým začne do adresáře vkládat více informací, například rozhodnutí o dodavatelích, plánovací rozhodnutí, rozhodnutí o harmonogramech atd. Všechny tyto druhy informací mohou používat stejnou šablonu. Domníváme se, že se lidé učí rychleji se slovy („rozhodnutí“) než se zkratkami („ADR“), že jsou více motivováni psát rozpracované dokumenty, když se odstraní slovo „záznam“, a také že někteří vývojáři a někteří manažeři slovo „architektura“ nemají rádi.

Teoreticky je neměnnost ideální. V praxi se našim týmům osvědčila spíše měnitelnost. Novou informaci vkládáme do stávajícího ADR s datem a poznámkou, že informace přišla po rozhodnutí. Tento přístup vede k „živému dokumentu“, který můžeme všichni aktualizovat. Typické aktualizace nastávají, když získáme informace díky novým kolegům, novým nabídkám, skutečným výsledkům našeho používání nebo dodatečným změnám třetích stran, jako jsou schopnosti dodavatelů, cenové plány, licenční smlouvy atd.