Vai al contenuto
CONTATTI

Legge della documentazione postuma

PROGRAMMAZIONE E BUG

La documentazione, quando esiste, descrive con grande precisione la versione precedente del programma.

— Anonimo, folklore informatico
VIDEO.EXE16:9

La documentazione tecnica è un genere letterario a sé, a metà tra il romanzo storico e il testamento. Racconta con dovizia di particolari un mondo che non c'è più: pulsanti spostati, menu rinominati, funzioni eliminate nel frattempo con una riunione di quattro minuti.

Il motivo è semplice. Il codice corre, la documentazione cammina. Quando finalmente qualcuno scrive il manuale della versione due, i programmatori stanno già litigando sulla quattro.

Ho un cliente che conserva il manuale del suo gestionale in una teca, come una reliquia. Ogni tanto lo apre e legge ad alta voce le istruzioni, con tono solenne. Nessuna corrisponde più allo schermo. Ma lui dice che lo aiuta a ricordare com'era il mondo quando i bottoni stavano a sinistra. E io, francamente, lo capisco.