Riktlinjer för hållbara beslut

Vi drog följande lärdomar i vårt arbete som kan fungera som riktlinjer och bedömning för att uppnå hållbara beslut:

Använd ett slimmat/minimalistiskt tillvägagångssätt för den inledande beslutsdokumentationen.
Prioritera och fånga alla viktiga beslut som är tillräckligt relevanta för att dokumentera och förstå målarkitekturen.
Detaljera de särskilt viktiga besluten med fullfjädrade mallar först efter att det inledande arbetet är gjort (det vill säga när beslutsfattarna är nöjda med de arkitekturbeslut som fattats och säkra på att besluten inte behöver ses över inom kort).
Använd de slimmade/minimalistiska versionerna från steg 1 som en kortversion av dokumenterade beslut med rätt granularitetsnivå för att ge en överblick över de detaljerade besluten, samt för triviala eller självklara beslut.
Använd om möjligt befintlig arkitekturkunskap, antingen från vägledningsmodeller eller från andra källor. Granska och utöka sådan kunskap och anpassa den till det specifika beslutets sammanhang.
Se till att spårbarhetslänkar upprättas mellan beslut och både krav och arkitekturdesigner/kod.
Tillhandahåll automatiserad konsekvenskontroll för att säkerställa att spårbarhetslänkarna är synkroniserade efter en ändring. Begränsa antalet beroenden mellan beslut och andra programvaruartefakter.
Tillämpa riktlinjerna för motiveringar konsekvent och kraftfullt – de är den viktigaste delen av beslutsdokumentationen eftersom de ger skälen.