Ver por etiquetas

Todas las etiquetas » comentarios (RSS)

13 Consejos para comentar tu código

Hace unos días publicaba una entrada donde hablaba de los problemas que generan la inclusión y el mantenimiento de comentarios en el código fuente de nuestras aplicaciones, aunque para no extenderme mucho sólo cité brevemente algunos aspectos a tener en cuenta a la hora de afrontar estos inconvenientes. Ahora, partiendo de estos consejos, la abundante literatura que hay sobre el tema y mi propia experiencia, he creado los 13 consejos para comentar tu código , que contribuirán a hacerlo más inteligible...

Problemas al comentar el código fuente

Si existieran los diez mandamientos del programador, seguro que uno de ellos sería " comenta tu código ". Y es que está claro que la mantenibilidad de una aplicación o módulo es posible siempre que los profesionales encargados de ella sean capaces de entender perfectamente qué hace el software y cómo lo hace, y es aquí donde un código correctamente documentado puede facilitar enormemente la tarea. Todos los lenguajes de programación facilitan la inclusión de texto libre, no estructurado...