Architecture Decision Record

Active theme: Light

← dokumenti

Smernice za dosego trajnostnih odločitev

https://www.infoq.com/articles/sustainable-architectural-design-decisions/

Pri svojem delu smo se naučili naslednjih spoznanj, ki lahko služijo kot smernice in ocena za doseganje trajnostnih odločitev:

  1. Za začetno dokumentiranje odločitev uporabite vitek/minimalističen pristop.

  2. Določite prednost in zajemite vse pomembne odločitve, ki so dovolj pomembne za dokumentiranje in razumevanje ciljne arhitekture.

  3. Posebej pomembne odločitve podrobno opišite s polnimi predlogami šele po opravljenem začetnem delu (to pomeni, ko so odločevalci zadovoljni s sprejetimi arhitekturnimi odločitvami in prepričani, da teh odločitev ne bo treba kmalu spreminjati).

  4. Vitke/minimalistične različice iz 1. koraka uporabite kot kratko različico dokumentiranih odločitev z ustrezno ravnjo granularnosti, da zagotovite pregled nad podrobnimi odločitvami ter za trivialne ali očitne odločitve.

  5. Kjer je mogoče, uporabite obstoječe arhitekturno znanje, bodisi iz vodilnih modelov bodisi iz drugih virov. Takšno znanje pregledajte, razširite in prilagodite kontekstu posamezne odločitve.

  6. Zagotovite, da so povezave za sledljivost vzpostavljene med odločitvami ter zahtevami in arhitekturnimi načrti/kodo.

  7. Zagotovite samodejno preverjanje skladnosti, da so povezave za sledljivost po spremembi usklajene. Omejite število odvisnosti med odločitvami in drugimi artefakti programske opreme.

  8. Smernice za utemeljitve uporabljajte dosledno in odločno – so najpomembnejši del dokumentacije odločitev, saj podajajo razloge.