ADRs werken alleen als ze kort, leesbaar en versioned zijn. Lange documenten in SharePoint zijn geen ADRs.
Wat hoort in een ADR thuis?
Context, beslissing, alternatieven en consequenties. Niet meer dan één pagina, geschreven zodat een nieuwe collega het binnen vijf minuten begrijpt.
Waar bewaart u ADRs?
Bij voorkeur in versiebeheer naast de codebase. Zo zijn ze gekoppeld aan een specifieke staat van de applicatie en niet kwijt na een tool-wissel.
Wie schrijft ADRs?
Architecten en lead developers samen, met een lichte review-routine. De architect helpt u die routine inrichten en zorgt dat hij niet ontaardt in proces.
Wat brengt onze architect mee?
Praktijk met ADRs in productie en het vermogen om uw team de gewoonte aan te leren.
Verwant: Applicatie Architect inhuren