¿Existe una guía definitiva para escribir comentarios de código, dirigida a desarrolladores incipientes?
Idealmente, cubriría cuándo deberían (y no deberían) usarse los comentarios, y qué comentarios deberían contener.
No comente QUÉ está haciendo, sino POR QUÉ lo está haciendo.
El QUÉ se soluciona mediante un código limpio, legible y simple con la elección adecuada de nombres de variables para admitirlo. Los comentarios muestran una estructura de nivel superior al código que no puede ser (o es difícil de mostrar) por el código mismo.
se acerca, pero es un poco conciso para programadores inexpertos (creo que una expansión con varios ejemplos y casos de esquina sería excelente).
Actualización : además de las respuestas aquí, creo que esta respuesta a otra pregunta es muy relevante.