Zásady na dosiahnutie udržateľných rozhodnutí

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

Pri našej práci sme sa naučili nasledujúce lekcie, ktoré môžu slúžiť ako zásady a hodnotenie pre dosiahnutie udržateľných rozhodnutí:

Použite štíhly/minimalistický prístup pre počiatočnú dokumentáciu rozhodnutí.
Priorizujte a zachyťte všetky dôležité rozhodnutia, ktoré sú dostatočne relevantné na to, aby sa zdokumentovali a aby sa pochopila cieľová architektúra.
Podrobne rozpracujte osobitne dôležité rozhodnutia plnohodnotnými šablónami až po dokončení počiatočnej práce (to znamená, keď sú rozhodovatelia spokojní s prijatými architektonickými rozhodnutiami a sú presvedčení, že tieto rozhodnutia nebude potrebné čoskoro revidovať).
Použite štíhle/minimalistické verzie z kroku 1 ako skrátenú verziu zdokumentovaných rozhodnutí so správnou úrovňou granularity na poskytnutie prehľadu o podrobných rozhodnutiach, ako aj pre triviálne alebo zrejmé rozhodnutia.
Všade, kde je to možné, používajte existujúce architektonické znalosti, či už z usmerňujúcich modelov, alebo z iných zdrojov. Preskúmajte a rozšírte takéto znalosti a prispôsobte ich kontextu konkrétneho rozhodnutia.
Zabezpečte, aby boli medzi rozhodnutiami a požiadavkami aj architektonickými návrhmi/kódom vytvorené odkazy na sledovateľnosť.
Zabezpečte automatizovanú kontrolu konzistentnosti, aby ste si boli istí, že odkazy na sledovateľnosť sú po zmene synchronizované. Obmedzte počet závislostí medzi rozhodnutiami a inými softvérovými artefaktmi.
Zásady pre zdôvodnenia uplatňujte dôsledne a razantne — sú najdôležitejšou súčasťou dokumentácie rozhodnutí, pretože poskytujú odôvodnenie.