Come registrare una decisione di architettura a partire da una riunione
Un ADR documenta una decisione di architettura significativa: contesto, alternative, scelta, conseguenze e stato. La trascrizione aiuta a recuperare le motivazioni. I partecipanti confermano la precisione tecnica.
Come scrivere un Architecture Decision Record da una discussione registrata
Un ADR documenta una decisione di architettura significativa: contesto, alternative, scelta, conseguenze e stato. La trascrizione aiuta a recuperare le motivazioni. I partecipanti confermano la precisione tecnica.
La trascrizione permette di verificare le formulazioni. Conserva il contesto, le precisazioni e l’ordine delle argomentazioni. Chi scrive decide il testo finale e lo fa verificare ai partecipanti.
Scrivi l’ADR passo per passo
Scegli una decisione
Usa una scheda distinta per ogni decisione di architettura indipendente.
Descrivi il contesto
Scrivi quali fattori e vincoli hanno reso necessaria la decisione.
Confronta le opzioni
Conserva i vantaggi e gli svantaggi principali di ogni opzione e i motivi per scartarla.
Indica le conseguenze
Elenca benefici, costi, nuovi vincoli, rischi e condizioni per rivedere la scelta.
Esempio didattico: come archiviare i file audio
L’esempio didattico seguente è fittizio. Nomi, condizioni e risultati servono esclusivamente a spiegare il metodo.
«Lo storage a oggetti costa meno per l’archivio, ma servirà un meccanismo separato per i link temporanei».
Contesto: le registrazioni sono grandi, l’accesso deve scadere e l’emissione dei link va controllata. La scelta è lo storage a oggetti. Oltre al costo, contano la scalabilità e il modello di accesso.
Fra le conseguenze indica il lavoro e i rischi: link temporanei, controllo della scadenza, registrazione degli eventi e test dei guasti. Se cambia l’ipotesi sui costi, un nuovo ADR può sostituire il precedente conservando la cronologia.
| Sezione | Annotazione utile | Esempio da evitare |
|---|---|---|
| Contesto | File grandi e accesso limitato | Serve un nuovo storage |
| Opzioni | Storage a oggetti / a file | Abbiamo scelto il migliore |
| Decisione | Storage a oggetti per i motivi A e B | Ha deciso l’architetto |
| Conseguenze | Link temporanei e monitoraggio | Nessuno svantaggio |
Modello di ADR
Copia il modello e compilalo usando una registrazione specifica. Presenta le supposizioni come ipotesi.
Titolo e stato: Data e partecipanti: Contesto e vincoli: Opzioni esaminate: Decisione e motivi: Conseguenze, rischi e condizioni di riesame:
Quattro controlli prima dell’invio
- La scheda documenta una decisione.
- Il contesto contiene vincoli reali.
- Le alternative e i motivi per scartarle sono indicati.
- Sono inclusi svantaggi e condizioni di riesame.
Entriamo nei dettagli
Si può modificare un ADR accettato?
Puoi correggere i refusi. Se cambia la decisione, crea un nuovo ADR e collegalo al precedente.
Occorre conservare la trascrizione insieme all’ADR?
Di solito un link alla fonte interna e un riferimento temporale bastano per verificare una frase controversa.