Een ADR documenteert context, beslissing, alternatieven en gevolgen. Geen lange documenten in SharePoint maar markdown naast de code.
Wat hoort in een ADR?
Maximaal één pagina, geschreven zodat een nieuwe collega het binnen vijf minuten begrijpt. Status: voorgesteld, geaccepteerd, verworpen of vervangen.
Waar bewaart u ze?
In versiebeheer naast de codebase. Zo zijn ze gekoppeld aan een specifieke staat van de applicatie.
Wie schrijft ADRs?
Architecten en lead developers samen, met lichte review-routine. De architect helpt u die routine inrichten.
Wat brengt onze architect mee?
Praktijk met ADRs in productie en het vermogen om uw team de gewoonte aan te leren.
Verwant: Ervaren Technisch Architect