Retningslinjer for bæredygtige beslutninger

I vores arbejde har vi lært følgende lektioner, som kan bruges som retningslinjer og evalueringskriterier for at opnå bæredygtige beslutninger:

Brug en lean/minimalistisk tilgang til den indledende dokumentation af beslutninger.
Prioritér og registrér alle vigtige beslutninger, der er relevante nok til at dokumentere og forstå målarkitekturen.
Udarbejd især vigtige beslutninger i en fuldgyldig skabelon først efter det indledende arbejde (dvs. når beslutningstagerne er tilfredse med de trufne arkitekturbeslutninger, og der er tillid til, at disse beslutninger ikke snart skal revideres).
Brug den lean/minimalistiske version fra trin 1 som oversigt over beslutninger dokumenteret på et passende granularitetsniveau for at give et overblik over de detaljerede beslutninger, og også til trivielle eller selvindlysende beslutninger.
Udnyt om muligt eksisterende arkitekturviden, hvad enten det er vejledende modeller eller andre kilder. Gennemgå og udvid denne viden, og tilpas den til konteksten for de specifikke beslutninger.
Sørg for, at der etableres sporbarhedslinks mellem beslutninger og både krav og arkitekturdesign/kode.
Sørg for automatiske konsistenskontroller, så sporbarhedslinks forbliver synkroniserede efter ændringer. Begræns antallet af afhængigheder mellem beslutninger og andre softwareartefakter.
Anvend retningslinjer for begrundelse konsekvent og stærkt. Begrundelsen er den vigtigste del af beslutningsdokumentationen, fordi den giver årsagen.