Idea principale

Un glossario di prodotto definisce le parole una per una: «ordine», «fattura», «cliente». Ogni voce può essere corretta, eppure l'insieme non insegna quasi nulla di ciò che il software fa. L'ordine descritto da solo resta un'etichetta. Lo stesso ordine effettuato da un cliente, che contiene delle righe, fatturato in una fattura, descrive un prodotto — perché sono i verbi a dire ciò che il business consente e ciò che vieta.

Un repertorio che dà un nome ai suoi collegamenti si distingue così dai tre artefatti che esistevano già intorno al prodotto: il glossario, che definisce senza collegare; lo schema della base di dati, che collega tabelle secondo vincoli tecnici e non secondo il business; la documentazione, che racconta per un lettore umano e non espone nessuna struttura interrogabile.

Il vincolo operativo si riduce a una regola di scrittura: nessun collegamento si scrive «è collegato a». Ogni collegamento porta un verbo e le cardinalità da entrambi i lati — un ordine è effettuato da un solo cliente e contiene almeno una riga.

Perché è importante

È ciò che rende la descrizione utilizzabile al di là della lettura. Un collegamento con un nome si verifica, si mette alla prova, si contraddice; «è collegato a» non si contraddice mai, quindi non prova niente. È anche ciò che permette a un agente di rispondere a una domanda sul comportamento del prodotto senza aprire il codice: la risposta sta nel percorso fra due schede.

E dà un criterio di arresto alla stesura di una scheda: finché i collegamenti restano vaghi, la scheda non è scritta, anche se tutti i campi sono compilati.

Sfumature e limiti

Il verbo preciso ha un costo: obbliga a decidere casi che la definizione lasciava in ombra — un ordine generato automaticamente è effettuato da qualcuno? Questo costo è proprio ciò che fa emergere le domande di prodotto, ma rallenta il primo passaggio.

E una rete di collegamenti corretti non dice niente della propria completezza: un insieme di schede che si citano solo fra loro chiude la propria rete molto prima di aver coperto il prodotto.

Domande aperte

• Fino a che punto bisogna normalizzare il vocabolario dei verbi stessi perché due redattori smettano di chiamare la stessa relazione in due modi diversi?