Architecture Decision Record

Active theme: Light

← dokumenti

Predlogi za pisanje dobrih ADR

Značilnosti dobrega ADR:

  • Utemeljitev: Pojasnite razloge za določeno AD. To lahko vključuje kontekst (glejte spodaj), prednosti in slabosti različnih možnih izbir, primerjave funkcij, razprave o stroških in koristih ter drugo.

  • Natančnost: Vsak ADR naj govori o eni AD, ne o več AD.

  • Časovni žigi: Navedite, kdaj je bil napisan posamezni element v ADR. To je še posebej pomembno za vidike, ki se lahko sčasoma spremenijo, na primer stroške, urnike, skaliranje in podobno.

  • Nespremenljivost: Ne spreminjajte obstoječih informacij v ADR. Namesto tega ADR dopolnite z dodajanjem novih informacij ali ga nadomestite z ustvarjanjem novega ADR.

Značilnosti dobrega razdelka »Kontekst« v ADR:

  • Pojasnite položaj svoje organizacije in poslovne prednostne naloge.

  • Vključite utemeljitve in premisleke, ki temeljijo na družbeni sestavi in veščinah vaših ekip.

  • Vključite prednosti in slabosti, ki so pomembne, ter jih opišite z izrazi, ki se skladajo z vašimi potrebami in cilji.

Značilnosti dobrega razdelka »Posledice« v ADR:

  • Pojasnite, kaj izhaja iz sprejetja odločitve. To lahko vključuje učinke, izide, izdelke, nadaljnje ukrepe in drugo.

  • Vključite informacije o morebitnih naslednjih ADR. Relativno pogosto en ADR sproži potrebo po dodatnih ADR, na primer ko en ADR sprejme veliko krovno izbiro, ta pa ustvari potrebe po več manjših odločitvah.

  • Vključite morebitne postopke pregleda po ukrepu. Običajno ekipe vsak ADR pregledajo en mesec pozneje, da primerjajo informacije v ADR s tem, kar se je zgodilo v praksi, in se tako učijo ter rastejo.

Nov ADR lahko nadomesti prejšnji ADR:

  • Ko je sprejeta AD, ki nadomesti ali razveljavi prejšnji ADR, je treba ustvariti nov ADR