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.
Un diagramma mostra soprattutto relazioni, confini, flussi o struttura. È efficace quando il problema è creare un modello mentale condiviso, ma non garantisce che siano espliciti contesto, assunzioni o rationale. Un modello introduce una semantica più forte: gli elementi rappresentano concetti definiti e possono supportare viste multiple dello stesso sistema. La documentazione collega invece informazioni diverse in una forma consumabile da una specifica audience e può includere diagrammi, testo, esempi e riferimenti. Un decision record cattura il contesto di una scelta, le alternative considerate, il motivo della decisione e le conseguenze. Le quattro forme possono sovrapporsi, ma non sono intercambiabili. Un diagramma senza spiegazioni può mostrare come è fatto un sistema senza dire perché è fatto così. Un decision record può spiegare perché è stata scelta una soluzione senza descriverne abbastanza la struttura. Un modello può garantire coerenza semantica senza fornire una narrazione adatta a uno stakeholder. La scelta corretta nasce dalla domanda che deve trovare risposta, non dalla preferenza personale per uno strumento o un formato.