Architecture Decision Record

Active theme: Light

← dokumenti

Smjernice za postizanje održivih odluka

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

U svom radu naučili smo sljedeće lekcije koje mogu poslužiti kao smjernice i procjena za postizanje održivih odluka:

  1. Koristite vitak/minimalistički pristup za početnu dokumentaciju odluka.

  2. Odredite prioritete i zabilježite sve važne odluke koje su dovoljno relevantne za dokumentiranje i razumijevanje ciljne arhitekture.

  3. Detaljno razradite osobito važne odluke potpunim predlošcima tek nakon što je početni rad obavljen (to jest, kada su donositelji odluka zadovoljni donesenim arhitekturnim odlukama i uvjereni da te odluke neće trebati uskoro revidirati).

  4. Koristite vitke/minimalističke verzije iz koraka 1 kao kratku verziju dokumentiranih odluka s pravom razinom granularnosti kako biste pružili pregled detaljnih odluka, kao i za trivijalne ili očite odluke.

  5. Gdje god je moguće, koristite postojeće arhitekturno znanje, bilo iz vodećih modela ili iz drugih izvora. Pregledajte i proširite takvo znanje te ga prilagodite kontekstu specifične odluke.

  6. Osigurajte da su uspostavljene poveznice sljedivosti između odluka i zahtjeva te arhitekturnih dizajna/koda.

  7. Osigurajte automatiziranu provjeru dosljednosti kako biste bili sigurni da su poveznice sljedivosti usklađene nakon promjene. Ograničite broj ovisnosti između odluka i drugih softverskih artefakata.

  8. Dosljedno i odlučno primjenjujte smjernice za obrazloženja — ona su najvažniji dio dokumentacije odluka jer daju razloge.