Architecture Decision Record

Active theme: Light

← dokumenter

Råd om teamarbeid for ADR-er

Hvis du vurderer å bruke beslutningslogger sammen med teamet ditt, får du her noen råd vi har lært av å arbeide med mange team.

Du har en mulighet til å gå foran som leder for teamkollegene dine ved å snakke sammen om «hvorfor» i stedet for å pålegge «hva». Beslutningslogger er for eksempel en måte for team å tenke smartere og kommunisere bedre på. De er ikke verdifulle hvis de bare er et krav om papirarbeid som tvinges inn i etterkant.

Noen team foretrekker navnet «beslutninger» framfor forkortelsen «ADR-er». Når noen team bruker katalognavnet «decisions», er det som om en lyspære tennes, og teamet begynner å legge mer informasjon i katalogen, for eksempel leverandørbeslutninger, planleggingsbeslutninger, tidsplanbeslutninger og så videre. Alle disse typene informasjon kan bruke samme mal. Vi antar at folk lærer raskere med ord («beslutninger») enn med forkortelser («ADR-er»), at folk blir mer motivert til å skrive dokumenter underveis når ordet «logg» fjernes, og at noen utviklere og noen ledere ikke liker ordet «arkitektur».

I teorien er uforanderlighet ideelt. I praksis har foranderlighet fungert bedre for teamene våre. Vi setter inn ny informasjon i den eksisterende ADR-en, med dato og en merknad om at informasjonen kom etter beslutningen. Denne tilnærmingen gir et «levende dokument» som vi alle kan oppdatere. Typiske oppdateringer kommer når vi får informasjon takket være nye teamkolleger eller nye tilbud, eller fra resultater av egen bruk i praksis, eller fra endringer hos tredjeparter i etterkant, for eksempel leverandørers funksjoner, prisplaner, lisensavtaler og så videre.