Cuando se escribe un código hay mucha información valiosa solamente en la propia cabeza y esta información se pierde. Todo lo que un futuro lector tiene es el código y los respectivos comentarios.
Entonces, el comentario es la herramienta para registrar los conocimientos que se quedarían únicamente en la cabeza y que son importantes para entender el código.
Idea clave: el comentario sirve para ayudar al lector a saber tanto cuanto el autor del código en el momento de su creación.
Ejemplo:
// Código de la tarea "Aprobar". Definido en el flujo del proceso en el ECM
#DEFINE NTASKAPR 3
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas