Idea principale

Una voce di glossario non è un mini-articolo. Non deve raccontare tutto su posizionamento, backlog o segnale cliente: deve rendere la parola utilizzabile da chi deve usarla in una discussione, in un ticket o in una decisione, nel momento stesso in cui la consulta.

Il criterio per dire che la scrittura è finita cambia quindi natura. Non è «ho esaurito il concetto?» — un concetto non si esaurisce — ma «chi legge può ora usare questa parola senza sbagliarne il senso, e accorgersi quando qualcun altro la usa diversamente?». Una voce che risponde a questa domanda è completa anche se lascia fuori interi pezzi dell'argomento.

Ciò che eccede non va perso: il ragionamento che si aveva voglia di scrivere nella voce è esattamente la materia di una nota atomica. La voce delega l'argomentazione e rimanda a essa.

Perché è importante

Protegge il glossario dalla deriva più comune — la voce che cresce fino a diventare un articolo, che nessuno consulta più perché costa troppo leggerla nel momento in cui serve. Un glossario si legge di passaggio; una voce lunga arriva sempre troppo tardi.

Dà anche un segnale di taglio: una voce che trabocca segnala una nota atomica da scrivere, non una voce da arricchire.

Sfumature e limiti

La brevità non è una regola di formato: una voce che deve dar conto di un senso normativo e di un uso sul campo divergenti sarà più lunga di una voce che ne ha uno solo, senza smettere di essere utilizzabile.

E un termine il cui senso è ancora conteso richiede di registrare il disaccordo invece di risolverlo in nome della concisione.

Domande aperte

• Come individuare, nel corpo di una voce già scritta, la frase che avrebbe dovuto diventare una nota atomica?