Architecture Decision Record

Active theme: Light

← dokumentumok

Csapatmunka-tanácsok ADR-ekhez

Ha azt fontolgatja, hogy döntési feljegyzéseket használjon a csapatával, íme néhány tanács, amelyet sok csapattal dolgozva tanultunk.

Lehetősége van vezetni a csapattársait azzal, hogy együtt beszélnek a „miértről”, ahelyett hogy a „mit” előírnák. Például a döntési feljegyzések a csapatok számára az okosabb gondolkodás és a jobb kommunikáció eszközei; a döntési feljegyzéseknek nincs értékük, ha csak utólagos, kényszerű papírmunkává válnak.

Néhány csapat sokkal jobban szereti a „döntések” nevet az „ADR” rövidítésnél. Amikor egyes csapatok a „decisions” könyvtárnevet használják, mintha felgyulladna egy villanykörte, és a csapat több információt kezd tenni a könyvtárba, például beszállítói döntéseket, tervezési döntéseket, ütemezési döntéseket stb. Mindezek az információfajták használhatják ugyanazt a sablont. Feltételezésünk szerint az emberek gyorsabban tanulnak szavakkal („döntések”), mint rövidítésekkel („ADR”), nagyobb a motivációjuk a folyamatban lévő dokumentumok megírására, ha elhagyjuk a „feljegyzés” szót, és néhány fejlesztő és néhány vezető nem szereti az „architektúra” szót.

Elméletben a megváltoztathatatlanság az ideális. A gyakorlatban a csapatainknál a módosíthatóság vált be jobban. Az új információt beillesztjük a meglévő ADR-be, dátumbélyeggel és megjegyzéssel, hogy az információ a döntés után érkezett. Ez a megközelítés „élő dokumentumhoz” vezet, amelyet mindannyian frissíthetünk. Tipikus frissítések, amikor új csapattársaknak, új ajánlatoknak, a használatunk valós eredményeinek köszönhetően jutunk információhoz, vagy utólagos harmadik felek általi változások miatt, például szállítói képességek, árazási tervek, licencszerződések stb.