Idea principale

La redditività di una descrizione di prodotto non segue il numero di schede scritte, segue la completezza di un perimetro. Un'area descritta per intero — diciamo la fatturazione — risponde alle domande del supporto, della prevendita, della formazione e degli sviluppatori che ci lavorano, e risponde senza che serva verificare altrove. Cinque aree descritte a metà non risparmiano nessuna di queste verifiche: a ogni domanda bisogna riaprire il codice per sapere se la risposta mancante manca davvero.

La ragione è asimmetrica. Una descrizione parziale porta valore solo se si sa dove passa il suo confine; altrimenti chi la usa deve sempre mettere in conto che taccia, e il costo di verifica torna intatto.

Da qui la condizione di utilizzo: finire un'area prima di aprirne un'altra. Contraddice la tendenza naturale di un lavoro del genere, che è toccare tutto in superficie per mostrare una copertura lusinghiera.

Perché è importante

Dà una regola di sequenza da opporre alla pressione di mostrare avanzamento: la tappa utile è «questo perimetro è finito», mai «l'n per cento del prodotto è coperto».

Vale per altri cantieri di conoscenza — una documentazione, un glossario, una base di test — il cui uso comincia solo nel momento in cui un utente può smettere di dubitare su una zona intera.

Sfumature e limiti

Il ragionamento presuppone perimetri realmente separabili. Su un prodotto in cui tutto dipende da tutto, nessuna area si chiude senza sconfinare, e la regola diventa un'istruzione di arresto arbitraria invece che una condizione di redditività.

E una copertura ampia, anche parziale, conserva un'utilità propria: serve a confrontare le angolazioni fra loro e a individuare dove il prodotto è conosciuto male.

Domande aperte

• Come dichiarare il confine di un perimetro descritto perché un lettore sappia, senza pensarci, se la sua domanda ci cade dentro o fuori?