Linee guida per ottenere decisioni sostenibili

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

Nel nostro lavoro abbiamo imparato le seguenti lezioni, che possono essere usate come linee guida e criteri di valutazione per ottenere decisioni sostenibili:

Usa un approccio lean/minimalista per la documentazione iniziale delle decisioni.
Dai priorità e registra tutte le decisioni importanti abbastanza rilevanti da documentare e comprendere l'architettura di destinazione.
Elabora le decisioni particolarmente importanti in un modello completo solo dopo il lavoro iniziale (cioè quando i decisori sono soddisfatti delle decisioni architetturali prese e c'è fiducia che queste decisioni non debbano essere riviste presto).
Usa la versione lean/minimalista del passo 1 come riepilogo delle decisioni documentate a un livello di granularità adeguato, per dare una panoramica delle decisioni dettagliate e anche per decisioni banali o ovvie.
Sfrutta, dove possibile, la conoscenza architetturale esistente, siano modelli guida o altre fonti. Rivedi ed estendi tale conoscenza e adattala al contesto delle decisioni specifiche.
Assicurati che vengano stabiliti collegamenti di tracciabilità tra le decisioni e sia i requisiti sia la progettazione architetturale/il codice.
Prevedi controlli di coerenza automatici in modo che i collegamenti di tracciabilità restino sincronizzati dopo le modifiche. Limita il numero di dipendenze tra le decisioni e gli altri artefatti software.
Applica le linee guida sulla motivazione in modo coerente e deciso. La motivazione è la parte più importante della documentazione delle decisioni, perché fornisce il perché.