Architecture Decision Record

Active theme: Light

← dokument

Tips för att skriva bra ADR:er

Kännetecken för en bra ADR:

  • Motivering: Förklara skälen till att fatta det specifika AD:t. Det kan omfatta sammanhanget (se nedan), för- och nackdelar med olika möjliga val, funktionsjämförelser, diskussioner om kostnad/nytta och mer.

  • Specifik: Varje ADR bör handla om ett AD, inte flera AD:n.

  • Tidsstämplar: Ange när varje punkt i ADR:en skrevs. Detta är särskilt viktigt för aspekter som kan förändras över tid, såsom kostnader, scheman, skalning och liknande.

  • Oföränderlig: Ändra inte befintlig information i en ADR. Komplettera i stället ADR:en genom att lägga till ny information, eller ersätt ADR:en genom att skapa en ny ADR.

Kännetecken för ett bra avsnitt ”Sammanhang” i en ADR:

  • Förklara din organisations situation och affärsprioriteringar.

  • Ta med motiveringar och överväganden som bygger på dina teams sociala sammansättning och kompetenser.

  • Ta med relevanta för- och nackdelar och beskriv dem i termer som stämmer överens med dina behov och mål.

Kännetecken för ett bra avsnitt ”Konsekvenser” i en ADR:

  • Förklara vad som följer av beslutet. Det kan omfatta effekter, utfall, resultat, uppföljning och mer.

  • Ta med information om eventuella efterföljande ADR:er. Det är relativt vanligt att en ADR utlöser behov av fler ADR:er, till exempel när en ADR gör ett stort övergripande val som i sin tur skapar behov av fler mindre beslut.

  • Ta med eventuella processer för efterhandsutvärdering. Det är vanligt att team granskar varje ADR en månad senare för att jämföra ADR-informationen med vad som hänt i praktiken, för att lära och växa.

En ny ADR kan ersätta en tidigare ADR:

  • När ett AD fattas som ersätter eller upphäver en tidigare ADR bör en ny ADR skapas