Cita:
Iniciado por ZeKi 
El mejor codigo es el que no necesita comentarios. Más que abusar de ellos, lo que debe hacer es un código auto-documentado en el que hagan falta los mínimos comentarios posibles para entenderlo.
Hombre, no se si eso es del todo cierto, ya que si a cualquier persona le hacen leer un codigo y ese codigo no tiene ningun comentario, es algo que por muy bien que este escrito, sera mas dificil de leer que algo que este comentado decentemente.
Lo de abusar de los comentarios lo decia como consejo inicial, evidentemente luego hay que acostumbrarse a hacer comentarios cortos y simples (por ejemplo un comentario que diga lo que hace una funcion o algo por el estilo).
Saludos.