- Et lite dokument som dokumenterer beslutninger relatert til den tekniske arkitekturen i et prosjekt.
- Dokumentet inneholder beslutningen og kontekst rundt denne, og eventuelle konsekvenser beslutningen medfører.
- En beslutningsfortegnelse er den norske oversettelsen for Architectural decision record (ADR).
- Dokumentasjon av beslutninger som er tatt gjør det enklere å integrere nye medlemmer i teamet.
- Dokumenter ligger sammen med kodebase, det gjør at sporbarheten for en beslutning øker.
- Vi kan gå tilbake i tid og se når dokumentet ble opprettet første gang, og følge utviklingen ved å se alle commits.
- En beslutningsfortegnelse dokumenterer også kontekst rundt beslutningen, ikke bare utfallet.
- Hvorfor beslutningen ble tatt, hvilke antagelser ble gjort og hvilke begrensninger som fantes.
- Beslutningstaker(e) dokumenterer sin tankegang gjennom hele prosessen.
- Beslutningsfortegnelsen lar oss definere et sett med beslutningsstandarder.
- Samme sett med beslutninger gjennomføres ofte på tvers av prosjekter i Epiteamet. Vi kan se tilbake på tidligere beslutninger når vi gjennomfører nye i et annet prosjekt.