Retningslinjer for å oppnå bærekraftige beslutninger

Vi har lært følgende av arbeidet vårt. Det kan brukes som retningslinjer og vurderingsgrunnlag for å oppnå bærekraftige beslutninger:

Bruk en slank og minimalistisk tilnærming til den første dokumentasjonen av beslutninger.
Prioriter og dokumenter alle viktige beslutninger som er relevante nok til å dokumentere og forstå målarkitekturen.
Beskriv de særlig viktige beslutningene i detalj med fullverdige maler først etter at det innledende arbeidet er gjort (det vil si når beslutningstakerne er fornøyde med arkitekturbeslutningene som er tatt og trygge på at beslutningene ikke må revideres med det første).
Bruk de slanke og minimalistiske versjonene fra trinn 1 som en kort versjon av de dokumenterte beslutningene, med riktig granularitetsnivå, for å gi en oversikt over de detaljerte beslutningene og for trivielle eller åpenbare beslutninger.
Bruk eksisterende arkitekturkunnskap der det er mulig, enten fra veiledningsmodeller eller andre kilder. Gjennomgå og utvid slik kunnskap og tilpass den til konteksten for den aktuelle beslutningen.
Sørg for at det opprettes sporbarhetslenker mellom beslutninger og både krav og arkitekturdesign/kode.
Sørg for automatisk konsistenssjekking, slik at sporbarhetslenkene er i takt etter en endring. Begrens antall avhengigheter mellom beslutninger og andre programvareartefakter.
Følg retningslinjene for begrunnelsene konsekvent og kraftfullt – de er den viktigste delen av dokumentasjonen av beslutninger fordi de gir grunnlaget.