Perdonate il titolo un po' blasfemo, ma l'argomento di discussione è uno di quelli adatti a generare una guerra di religione tra programmatori.
Le mie idee sui commenti sono semplici:
Se trovi un commento nel codice, non crederci: verifica cosa ne pensa il codice.
Se stai per scrivere un commento, fermati, chiediti perchè, e tenta di non scriverlo.
Prima di essere assalito come pazzo offuscatore di codice, cerchiamo di capirci.
Ci sono varie categorie di commenti inutili e offensivi (se non dannosi) che pascolano per i sorgenti in giro per il mondo.
I commenti didattici
Hanno forse utilità per un docente di informatica, che li richiede a quattordicenni casinari per distinguere errori di sintassi da errori di concetto, non per persone pagate per scrivere software 8 ore al giorno.
I commenti storici
Perchè?!? Che tra l'altro magari Piero si è licenziato il mese scorso...
I commenti archeologici
Almeno quelli storici sono veri... e non sempre è così banale accorgersi della menzogna!
I commenti che dovrebbero essere metodi
perchè non scrivere subito:
Il codice commentato
Perchè affezionarsi a righe inutili? Se stiamo lavorando in modo serio è auspicabile avere un repository del codice, e ci pensa lui a tenere traccia del passato.
Così sembro un po' più ragionevole vero? :)
Commentare ha un senso, ma meno di quanto pensiamo.
E' corretto commentare cose complicate. Complicate nel senso che non si può o non si riesce a renderle più palesi nel codice. Ma nel resto dei casi...