Comentarios de código útiles e inútiles

Jim Nielsen :

Si alguien dice que un comentario no aporta ningún valor, yo preguntaría: ¿a quién?

Personalmente, nunca me ha gustado el consejo de que escribir comentarios obvios es una mala práctica, probablemente porque escribo comentarios obvios todo el tiempo.

Jim mostró algunos ejemplos de “comentarios de código que tienen el mismo nivel de fidelidad que el código mismo”. Esas son las llamadas más difíciles con comentarios de código.

// this function adds two numbersfunction add(a, b) {  return a + b;}

Es fácil señalar eso y decir que no es útil. Tiendo a no dejar este tipo de comentarios, pero es justo que Jim lo cuestione. Los comentarios se pueden utilizar para una amplia gama de personas que en algún momento pueden interactuar con ese código, entonces, ¿por qué conservarlo?

[…] los comentarios pueden tener un propósito muy diferente cuando se leen y cuando se escriben. Son casi dos tipos diferentes de actividades.

Agregaría que tienen un propósito diferente cuando se revisa el código antiguo en lugar de cuando se trabaja activamente. También es diferente cuando intentas revisar el código o contribuir directamente.