Al programar en una computadora, a veces es necesario dejar notas o comentarios para que otros desarrolladores puedan navegar por su código con facilidad. Ya sea un proyecto de código abierto o un proyecto propietario, se necesitan comentarios para coordinar con los co-desarrolladores y también con los posibles futuros desarrolladores. Sin comentarios, el código simplemente no se podría mantener.
Pasos
Paso 1. Comprender el propósito de comentar un programa de computadora
- La legibilidad es la clave aquí. Cuando miras un comentario, debes saber que es un comentario y no una línea de código.
- El comentario también debería ser útil no solo para usted, sino también para cualquier otra persona que pueda leer el código fuente de su programa de computadora.
Paso 2. Piense en una forma breve y sencilla de transmitir su punto
Los comentarios no tienen por qué ser una obra de arte. Deben ser concisos, prolijos y directos al grano.
Sin embargo, esto no debería desalentar el uso de varias líneas para un comentario. El punto es que la información debe llegar al lector
Paso 3. Escriba el comentario utilizando la sintaxis adecuada proporcionada por el lenguaje de programación
Paso 4. Pregúntese si el comentario que ha escrito es lo suficientemente detallado
Un comentario debería poder decirle a alguien que mira el código fuente qué hace realmente esa parte del programa sin tener que compilarlo y ejecutarlo. ¿Tu comentario logra esto? ¿Transmite todos los detalles?
