Idea

La divergenza tra documentazione e codice è una scelta di costo, non una negligenza

Info

Scritto originalmente in francese. Tradotto dall'IA — il significato è stato preservato, non la prosa.

Idea principale

Quando un team constata che una specifica non è più aggiornata, il riflesso è vederci una mancanza di rigore. Il meccanismo sta altrove. A ogni modifica, anche minima, bisognerebbe ritrovare la specifica giusta, il mockup giusto, il documento di supporto giusto e la voce di changelog giusta, e poi correggerli tutti. Questo lavoro è proporzionale al numero di artefatti, non all'entità della modifica: correggere un'etichetta può richiedere di mettere mano a cinque documenti.

Su un prodotto vivo, adattato e arricchito per mesi o anni, la somma di queste risincronizzazioni supera il tempo disponibile. Nessuno decide di lasciar divergere; ognuno decide, ancora una volta, che non è quello che farà nella prossima ora. La divergenza è il risultato cumulato di queste scelte, tutte ragionevoli prese una per una.

Per questo il rimedio basato sulla disciplina non funziona: chiede di vincere con la forza di volontà una partita che si gioca sui costi.

Perché è importante

Sposta il luogo della soluzione. Finché la divergenza viene letta come negligenza, si risponde con regole, revisioni e promemoria — che aggiungono costo a un'operazione già troppo cara. Letta come una scelta di costo, richiede una risposta sul costo: ridurre il numero di artefatti da tenere aggiornati, o ridurre il prezzo del loro aggiornamento.

Evita anche di attribuire a un team un difetto che appartiene alla struttura del suo lavoro.

Sfumature e limiti

La scelta non è difendibile allo stesso modo ovunque: un changelog consegnato al cliente e un mockup di lavoro interno non hanno le stesse conseguenze quando divergono. Il costo risparmiato non viene pagato nello stesso posto.

E la dimostrazione vale per un prodotto che evolve di continuo. Su un perimetro congelato, la risincronizzazione è un costo una tantum, e l'argomento cade.

Domande aperte

  • Come misurare il costo realmente pagato per una divergenza, per confrontarlo con il costo della manutenzione?