Architecture Decision Record

Active theme: Light

← dokumenty

Tipy na písanie dobrých ADR

Charakteristiky dobrého ADR:

  • Zdôvodnenie: Vysvetlite dôvody konkrétneho AD. To môže zahŕňať kontext (pozri nižšie), výhody a nevýhody rôznych možných volieb, porovnania funkcií, diskusie o nákladoch a prínosoch a ďalšie.

  • Konkrétnosť: Každý ADR by mal byť o jednom AD, nie o viacerých AD.

  • Časové pečiatky: Uveďte, kedy bola každá položka v ADR napísaná. To je obzvlášť dôležité pre aspekty, ktoré sa môžu v čase meniť, ako sú náklady, harmonogramy, škálovanie a podobne.

  • Nemennosť: Neupravujte existujúce informácie v ADR. Namiesto toho ADR doplňte pridaním nových informácií alebo ADR nahraďte vytvorením nového ADR.

Charakteristiky dobrej sekcie „Kontext“ v ADR:

  • Vysvetlite situáciu vašej organizácie a obchodné priority.

  • Zahrňte zdôvodnenie a úvahy založené na sociálnom a zručnostnom zložení vašich tímov.

  • Zahrňte relevantné výhody a nevýhody a opíšte ich výrazmi, ktoré zodpovedajú vašim potrebám a cieľom.

Charakteristiky dobrej sekcie „Dôsledky“ v ADR:

  • Vysvetlite, čo vyplýva z prijatia rozhodnutia. To môže zahŕňať účinky, výsledky, výstupy, nadväzujúce kroky a ďalšie.

  • Zahrňte informácie o všetkých následných ADR. Je pomerne bežné, že jeden ADR vyvolá potrebu ďalších ADR, napríklad keď jeden ADR urobí veľkú zastrešujúcu voľbu, ktorá zasa vytvorí potrebu viacerých menších rozhodnutí.

  • Zahrňte všetky procesy revízie po akcii. Je typické, že tímy preskúmajú každý ADR o mesiac neskôr, aby porovnali informácie v ADR s tým, čo sa stalo v skutočnej praxi, aby sa učili a rástli.

Nový ADR môže nahradiť predchádzajúci ADR:

  • Keď sa urobí AD, ktoré nahrádza alebo zneplatňuje predchádzajúci ADR, mal by sa vytvoriť nový ADR