Architecture Decision Record

Active theme: Light

← dokumenter

Tips for å skrive gode ADR-er

Kjennetegn på en god ADR:

  • Begrunnelse: Forklar grunnene til at den aktuelle AD-en tas. Det kan omfatte konteksten (se nedenfor), fordeler og ulemper ved ulike mulige valg, sammenligning av funksjoner, diskusjoner om kostnad og nytte, og mer.

  • Avgrenset: Hver ADR skal handle om én AD, ikke flere.

  • Tidsstempler: Angi når hvert punkt i ADR-en er skrevet. Dette er særlig viktig for forhold som kan endre seg over tid, som kostnader, tidsplaner, skalering og lignende.

  • Uforanderlig: Ikke endre eksisterende informasjon i en ADR. Utvid i stedet ADR-en med ny informasjon, eller erstatt ADR-en ved å lage en ny ADR.

Kjennetegn på en god «Kontekst»-del i en ADR:

  • Forklar organisasjonens situasjon og forretningsmessige prioriteringer.

  • Ta med begrunnelser og hensyn som bygger på teamenes sosiale sammensetning og kompetanse.

  • Ta med fordeler og ulemper som er relevante, og beskriv dem på måter som stemmer med dine behov og mål.

Kjennetegn på en god «Konsekvenser»-del i en ADR:

  • Forklar hva som følger av å ta beslutningen. Det kan omfatte virkninger, utfall, resultater, oppfølging og mer.

  • Ta med informasjon om eventuelle etterfølgende ADR-er. Det er ganske vanlig at én ADR utløser behov for flere ADR-er, for eksempel når én ADR gjør et stort overordnet valg som igjen skaper behov for flere mindre beslutninger.

  • Ta med eventuelle prosesser for gjennomgang i etterkant. Det er vanlig at team gjennomgår hver ADR en måned senere, for å sammenligne informasjonen i ADR-en med det som faktisk har skjedd i praksis, slik at de kan lære og utvikle seg.

En ny ADR kan erstatte en tidligere ADR:

  • Når det tas en AD som erstatter eller opphever en tidligere ADR, bør det lages en ny ADR