Architecture Decision Record

Active theme: Light

← dokumenter

Teamarbejdsråd til ADR'er

Hvis du overvejer at bruge beslutningsposter i dit team, er her nogle råd, vi har lært ved at arbejde med flere teams.

Der er mulighed for at lede teammedlemmer ved at tale om "hvorfor" frem for at gennemtvinge "hvad". Beslutningsposter er for eksempel en måde for teams at tænke klogere og kommunikere bedre. Hvis beslutningsposter blot er et papirarbejdskrav, der gennemtvinges bagefter, har de ingen værdi.

Nogle teams foretrækker i høj grad navnet "beslutninger" frem for forkortelsen "ADR". Når nogle teams bruger "decisions" som mappenavn, går der et lys op, og teams begynder at lægge flere oplysninger i mappen, såsom leverandørbeslutninger, planbeslutninger, tidsplanbeslutninger og så videre. Du kan bruge den samme skabelon til alle disse slags oplysninger. Vi antager, at folk lærer hurtigere med ordet ("beslutning") end med forkortelsen ("ADR"), at udeladelsen af ordet "post" giver mere motivation til at skrive igangværende arbejde, og at nogle udviklere og nogle ledere ikke bryder sig om ordet "arkitektur".

I teorien er uforanderlighed ideel. I praksis fungerede foranderlighed bedre for vores team. Vi indsætter nye oplysninger i en eksisterende ADR med et datostempel og en note om, at oplysningerne kom ind efter beslutningen. Denne tilgang fører til et "levende dokument", som vi alle kan opdatere. Typiske opdateringer kommer fra at få oplysninger takket være nye teammedlemmer, nye tilbud, faktiske resultater af vores brug eller efter efterfølgende ændringer fra tredjepart såsom leverandørers funktioner, prisplaner og licensaftaler.