Legge del commento bugiardo
Quando il commento e il codice non sono d'accordo, probabilmente hanno torto tutti e due.
I commenti sono le frasi che i programmatori lasciano nel codice per spiegare cosa fa. In teoria sono un gesto di gentilezza verso chi verrà dopo. In pratica sono come i cartelli stradali di una strada che nel frattempo è stata spostata.
Il codice viene cambiato, il commento resta. Così trovi scritto «calcola lo sconto del dieci per cento» sopra una funzione che manda una mail al direttore. Chi ha ragione? Nessuno. Il commento racconta un'intenzione antica, il codice un incidente moderno.
Esiste anche la scuola di pensiero opposta, quella dei programmatori fieri che non commentano mai: se è stato difficile da scrivere, deve essere difficile da capire. Io sto in mezzo. Commento sempre, ma con frasi tipo «non toccare». Non spiega niente, ma salva molte vite.