I dati obsoleti nei documenti aziendali spesso non nascono da un errore. Chi ha scritto la cifra l’aveva misurata bene. Il guaio è che il documento non dice quando, né da dove, né come rifare il conto. Il lettore si fida e decide in base a un dato che nel frattempo è cambiato.
Il caso che lo ha insegnato
Nelle nostre regole di lavoro è documentato un caso preciso. Un documento di deploy, cioè di messa in servizio di una nuova versione di un programma, dichiarava una credenziale di accesso, cioè un permesso per entrare in un servizio. Era «valida fino a una certa data (N giorni residui)». Quando qualcuno l’ha riletto, la data limite era già passata. Il numero dei giorni residui, scritto a mano il giorno della stesura, era rimasto fermo mentre i giorni veri passavano. Contati davvero, sarebbero stati negativi, ma la riga si leggeva ancora come «valido».
Nessuno aveva sbagliato. Il numero era esatto quando è stato scritto ed è diventato falso restando fermo. Il dettaglio più scomodo è un altro: una credenziale in regola e una scaduta producevano la stessa riga. Chi rilegge per decidere conclude che va tutto bene. Un dato scaduto non diventa evidentemente sbagliato: diventa rassicurante.
Lo stesso meccanismo agisce su un conteggio che cresce con il lavoro. Immaginate di copiare in una presentazione il numero dei clienti attivi. La settimana dopo è sbagliato, anche se nessuno ha toccato la presentazione. Peggio ancora: «quanti clienti abbiamo», «quanti hanno pagato» e «quanti hanno rinnovato» sono tre numeri diversi, tutti veri. Una cifra senza la sua domanda porta il lettore a rispondere a un’altra domanda.
Il principio in una frase
Un numero è un’osservazione. Vale insieme all’ora in cui è stata fatta, al punto da cui è stata fatta e al modo per rifarla. Senza questi tre elementi, è un’opinione.
Tre gesti
- Scrivete ora, base e unità di misura accanto alla cifra. Per esempio: «Misurato il 12 novembre alle 10:40, su questa copia dei dati, contando questa cosa.» La base è il punto da cui si misura, e conta quanto l’ora. Lo stesso conteggio su due copie dello stesso foglio di calcolo, una aggiornata e una indietro, dà due valori veri. Se la cifra non è vostra, dichiaratelo e dite se l’avete rifatta voi. Ripubblicarla senza ricontarla, quando potevate, ne cambia solo la firma. Scrivete anche ciò che non avete verificato: è metà dell’informazione.
- Se il numero è calcolato da una data, togliete il calcolo e lasciate la data. Un conteggio come «12 giorni residui» è un’operazione fatta una volta e mai ripetuta. Scrivete invece la data, per esempio «scade il 3 marzo», e lasciate che sia chi legge a fare la sottrazione. Prima, però, controllate che il fatto sia ancora vero. Togliere il conteggio rende la riga più pulita, ma altrettanto falsa: non è un ritocco di forma, è una verifica. Si comincia dai documenti la cui data limite è già passata, perché sono già falsi. Gli altri lo diventeranno.
- Al posto della cifra, scrivete il comando che la rifà, dopo averlo eseguito una volta. Il comando è l’istruzione che ricalcola il numero, per esempio una ricerca in un archivio. Se non l’avete mai provato, è un’ipotesi sul sistema, non un criterio. Vale anche per lo stato di un lavoro, scritto in una issue (la segnalazione di un lavoro da fare) o sulla bacheca delle angels, i ruoli AI che lavorano dentro la Console. Una voce «in attesa di risposta» non può risultare scaduta: resta vera anche dopo l’arrivo della risposta. Una voce «si chiude quando questo comando dà zero» si smentisce da sola appena il fatto cambia.
Che cosa costa
Costa una riga in più per ogni cifra importante e un comando da tenere funzionante. Il comando può rompersi, o rispondere a una domanda diversa da quella che il lettore ha in mente: per questo si esegue prima di prescriverlo. Inoltre l’ora non rende vero il numero. Dice soltanto quanto fidarsene. È già parecchio: tra un dato fresco e uno di ieri la differenza sta nell’uso che se ne fa, non nel valore.
Quando non vale
Non ogni cifra invecchia, e annotarle tutte rende i documenti illeggibili. Il risultato di un esercizio concluso descrive un momento, e il momento è già nel titolo. In una fattura l’importo e la data fanno parte del documento: non c’è nulla da rifare. Un dato di legge porta la sua data dentro, come l’entrata in vigore di una norma. Resta da controllare che la norma non sia cambiata, ma è un altro lavoro. Stime, soglie e durate, come «avvisa a trenta giorni dalla scadenza», sono scelte e non osservazioni: non cambiano da sole.
Per scegliere non basta vedere un numero seguito da un tempo, come «30 giorni»: darebbe falsi allarmi in quasi ogni pagina. La domanda giusta è un’altra. Il numero è calcolato da una data, o descrive una situazione che può cambiare? Se vale l’una o l’altra cosa, deve portare l’ora e il modo di rifarlo. Altrimenti lasciatelo in pace.
Prima di fidarvi di una cifra in un documento, chiedete quando è stata presa, da dove e con quale comando si rifà.
Vedete la Console al lavoro: https://console.biomine.it