Zásady pro dosažení udržitelných rozhodnutí

Při své práci jsme se naučili následující poučení, která mohou sloužit jako zásady a hodnocení pro dosažení udržitelných rozhodnutí:

Pro počáteční dokumentaci rozhodnutí použijte štíhlý/minimalistický přístup.
Určete priority a zachyťte všechna důležitá rozhodnutí, která jsou dostatečně relevantní pro dokumentaci a pochopení cílové architektury.
Zvlášť důležitá rozhodnutí rozpracujte do plnohodnotných šablon až poté, co je dokončena počáteční práce (tedy když jsou ti, kdo rozhodují, spokojeni s učiněnými architektonickými rozhodnutími a jsou si jisti, že se tato rozhodnutí nebudou muset brzy revidovat).
Použijte štíhlé/minimalistické verze z kroku 1 jako krátkou verzi zdokumentovaných rozhodnutí se správnou úrovní granularity, aby poskytly přehled podrobných rozhodnutí, a také pro triviální nebo zřejmá rozhodnutí.
Kdekoli je to možné, používejte stávající architektonické znalosti, ať už z modelů vedení, nebo z jiných zdrojů. Tyto znalosti přezkoumejte, rozšiřte a přizpůsobte kontextu konkrétního rozhodnutí.
Zajistěte, aby byly mezi rozhodnutími a jak požadavky, tak architektonickými návrhy/kódem vytvořeny odkazy na dohledatelnost.
Zajistěte automatickou kontrolu konzistence, aby odkazy na dohledatelnost zůstaly po změně synchronizované. Omezte počet závislostí mezi rozhodnutími a dalšími softwarovými artefakty.
Zásady pro zdůvodnění uplatňujte důsledně a důrazně — jsou nejdůležitější částí dokumentace rozhodnutí, protože poskytují odůvodnění.