Architecture Decision Record

Active theme: Light

← dokumenti

Savjeti za pisanje dobrih ADR-ova

Karakteristike dobrog ADR-a:

  • Obrazloženje: Objasnite razloge za konkretnu AD. To može uključivati kontekst (vidi dolje), prednosti i nedostatke različitih mogućih izbora, usporedbe značajki, rasprave o trošku i koristi i više.

  • Specifičnost: Svaki ADR trebao bi biti o jednoj AD, a ne o više AD-ova.

  • Vremenske oznake: Navedite kada je napisana svaka stavka u ADR-u. To je osobito važno za aspekte koji se mogu mijenjati tijekom vremena, kao što su troškovi, rasporedi, skaliranje i slično.

  • Nepromjenjivost: Ne mijenjajte postojeće informacije u ADR-u. Umjesto toga dopunite ADR dodavanjem novih informacija ili zamijenite ADR stvaranjem novog ADR-a.

Karakteristike dobrog odjeljka „Kontekst“ u ADR-u:

  • Objasnite situaciju svoje organizacije i poslovne prioritete.

  • Uključite obrazloženje i razmatranja temeljena na društvenom i vještinskom sastavu vaših timova.

  • Uključite relevantne prednosti i nedostatke i opišite ih izrazima koji su u skladu s vašim potrebama i ciljevima.

Karakteristike dobrog odjeljka „Posljedice“ u ADR-u:

  • Objasnite što slijedi iz donošenja odluke. To može uključivati učinke, ishode, izlaze, nastavke i više.

  • Uključite informacije o svim naknadnim ADR-ovima. Relativno je uobičajeno da jedan ADR potakne potrebu za više ADR-ova, na primjer kada jedan ADR donosi veliki sveobuhvatni izbor koji zauzvrat stvara potrebe za više manjih odluka.

  • Uključite sve procese pregleda nakon akcije. Tipično je da timovi pregledavaju svaki ADR mjesec dana kasnije, kako bi usporedili informacije iz ADR-a s onim što se dogodilo u stvarnoj praksi, da bi učili i rasli.

Novi ADR može zauzeti mjesto prethodnog ADR-a:

  • Kada se donese AD koja zamjenjuje ili poništava prethodni ADR, treba stvoriti novi ADR