Hace algun tiempo leí este artículo, y me pareció muy interesante:

Tip 1: Comenta como una persona inteligente

Comenta tu código. Obviamente. Si escribes un procedimiento sin comentarios, y luego de algunos meses vuelves a trabajr en él, el no tener comentarios te comerá tiempo. Y el tiempo es tu recurso más importante. Tiempo perdido no puede ser reemplazado.

Pero comentar, como cualquier cosa, es una habilidad. Te vuelves mejor con la práctica. Hay buenos comentarios, y los hay malos.

Tu no quieres escribir mucho. Suponte que escribes comentarios que, en el futuro, te resta diez minutos a entender tu código. Pero también supon que tus comentarios son tan largos que te toma cinco minutos escribirlos, luego, cinco minutos leerlos. Entonces no has ganado nada.

No quieres escribir muy poco, tampoco....


A terminar