Asset
Diagramma, modello, documentazione e decisione non sono la stessa cosa
Una distinzione operativa tra quattro forme spesso confuse tra loro, utile per scegliere quale evidenza manca davvero.
Quattro forme con scopi diversi
Diagramma, modello, documentazione e decision record possono convivere, ma rispondono a bisogni diversi. Confonderli porta ad aspettarsi da una forma evidenze che non può fornire da sola.
Che cosa offre ciascuna forma
- Diagramma: relazioni, confini, flussi o struttura.
- Modello: concetti definiti, semantica coerente e viste multiple.
- Documentazione: informazioni organizzate per uno specifico pubblico.
- Decision record: contesto, alternative, scelta e conseguenze.
Perché non sono intercambiabili
Un diagramma può mostrare come è fatto un sistema senza spiegare perché. Un ADR può spiegare perché è stata scelta una soluzione senza descrivere abbastanza la struttura. Un modello può garantire coerenza semantica senza offrire una narrazione comprensibile a uno stakeholder.