Si recién te estas iniciando en el mundo de la programación este es un consejo a tener en cuenta. Muchas veces quizás por falta de tiempo, apuro o simplemente por ignorancia no hacemos uso de una herramienta que absolutamente todos los Lenguaje de programación la contienen y que son los Comentarios, la herramienta de documentación por excelencia.
Como les decía es probable que por falta de tiempo u otras cuestiones no coloquemos comentarios en nuestro código, probablemente si estamos hablando de una aplicación muy simple o pequeña, a lo largo de un tiempo podremos leer dicho código sin ningún problema. Es problema surge cuando la complejidad del programa crece y las versiones van cambiando.
Para tener en cuenta:
- Es importante agregar los comentarios en la Cabecera de cada archivo de nuestro código fuente con una breve descripción de lo que encontramos en dicho archivo, y muchas veces suele colocar en esta parte del archivo un fragmento de la licencia escogida para el código, el o los nombres de los programadores encargados, la fecha de creación y modificación, algo importante es la versión.
- En otro lugar en donde nos vendría fantástico colocar comentarios es en aquellas funciones complejas, para tener algún modo de recordarlas o de saber que es lo que realizan.
- Es importante no llegar al abuso de los comentarios, si bien es una herramienta de documentación bastante importante y que no influyen para nada a la hora de interpretar o compilar sus códigos, pero aveces se puede tornar molesto ver tanta documentación.
Es por ello que les recomiendo llegar a un equilibrio, intentar trabajar con Comentarios discretos, y que describan el archivo, y lo máximo de prolijidad en nuestro código fuente hace que no tengamos que utilizar tantos comentarios.
Recuerda que seguimos publicando artículos periódicamente, así que no te olvides de suscribirte a nuestro Feed RSS si no quieres perderte ninguno de nuestros informes.
![Como descomprimir un archivo CSS [mejorado]](http://www.elcodigok.com.ar/wp-content/themes/mashlife/includes/timthumb.php?src=http%3A%2F%2Fs1.elcodigok.com.ar%2F2012%2F01%2Fcss_code.jpg&h=&w=&zc=1)
