En principio creo que los comentarios sí son necesarios, pero yo intento aprovecharlos para documentar el código.
En Python uso docstrings que pueden usarse con pydoc, en C y C++ no he llegado a usar cweb, pero si he trabajado con DOC++ (de hecho durante una época también lo usé con Java además del JavaDoc).
Comentarios y literate programming
(Puntos:1)En Python uso docstrings que pueden usarse con pydoc, en C y C++ no he llegado a usar cweb, pero si he trabajado con DOC++ (de hecho durante una época también lo usé con Java además del JavaDoc).
Para el que esté interesado hay una lista de herramientas útiles para hacer literate programming en http://www.literateprogramming.com/ftools.html [literateprogramming.com]