Mitos sobre los comentarios en el código:
- Son gratis
- Hacen el código “más legible”
- Se debe comentar cada función, método, clase y módulo
- El código debe documentarse a sí mismo
En lo personal yo detesto el #3, o aún peor cuando son generados automáticamente por algún IDE causando más ruido que beneficios en el código.
Javier Aroche 