Barrapunto

Más o menos eso pienso yo (aunque en realidad abogo por el "una línea de comentario por cada línea de código"). Lo de los peligros de sobrecomentar no acabo de entenderlo. Me imagino que ese pensamiento viene de parte de gente a la que no se le da bien escribir o expresarse. En cuanto a que los comentarios pueden distrer la atención, tampoco lo tengo claro. Desde hace milenios se puede configurar cualquier editor para que muestre los comentarios con el color y el tipo de letra que queramos. Yo los tengo configurados en gris, que se disimula bastante bien con el fondo blanco (con el negro también, si editas desde la shell), por lo que no molestan mucho.

Pues yo me quedaría un buen rato pensando: ¿porqué ha puesto el comentario?, ¿querrá expresar algo adicional a lo que ya expresa el código?, además pone Llamamos, o sea que no sido sólo una persona sino que han sido varias quienes han tomado la decisión, si se ha puesto ese comentario trivial seguro que ha sido porque es muy importante reflejar el hecho de llamar a la función sumar.

En fin, que después de darle muchas vueltas a la cabeza seguro que intentaría contactar con el que escribió el código porque no entiendo que significado aporta poner ese comentario cuando está explícitamente indicado en el código.