¿A quién le gusta poner comentarios en sus programas? Levante la mano ... ups, bueno ahora ya no hay excusa para no poner comentarios, llegó finalmente "El Comentador", el único software que apoya con tecnología multimedia el comentario en los programas.
Hablando de comentarios en los programas, estos son un lujo (para gente con criterio formado ...) ;-)
Ahora de verdad: el mejor comentario es un código simple y bien escrito, con identificadores bien elegidos.
Palabras clave: comentarios
Comentarios
me quedo con el último párrafo.
Lo anterior es para tomar un susto...
Una de las prácticas que produce dolor de cabeza es el uso de comentarios en los programas
Allá por el 2003 cuando trabajé en una empresa que estaba desarrollando un proyecto grande vi comentarios similares a los que se mencionan, los chistoso es que no es broma.
Pero bueno, ahora en serio. Creo que los comentarios son muy importantes, pero hay que saber donde usarlos, es mentira que debes comentar todo lo que parece código, el hecho de decir que el código se auto-documenta no es cierto en todos los casos. Seguir una conveción al programar es algo importante que cualquier programador profesional debería de hacerlo, pero el hablar de comentarios no está directamente relacionado a como nombras tus identificadores.
Lo que merece (y la práctica me ha demostrado) ser comentado son los algoritmos implementados en tu código. No importa como estén nombradas tus variables o cuan bien has utilizados las normas de programación. Si lo que tiene el código es complejo, y no está documentado, te aseguro que si vuelves dentro de unos meses a tratar de modificar esa lógica que no es trivial por cierto, puede ser que no recuerdes lo que tienes en frente, he visto a gente que le ha pasado e incluso a mí me pasó en mis primeros días de programación de de algoritmos complejos. Pero así aprendí que hay cosas que valen la pena documentar a través de comentarios, y esas cosas son principalmente la lógica no trivial.
Es cierto que es un poco difícil habituarse a hacerlo, cuesta, pero tiene grandes ventajas cuando llegas a la etapa de mantenimiento de tu software, ahí si que te ahorra horas de analizar código que puede ser tuyo o peor aún de otro que no ha comentado nada en operaciones complejas.
a mi
A mi tambi'en me gusta poner comentarios, para que mi legado pueda ser desencriptado por las generaciones futuras ja ja, bueno la verdad es que cuando veo un c'odigo que ya de por si parece hecho en VisualBasic (por lo feo) y no tiene comentarios de que es lo que realmente hace o que funci'on cumplen sus par'ametros, reniego mucho :p
Que capos los de "The commentator", si que hay gente con mucha imaginaci'on y mucho pero muuchoo tiempo libre no? ja ja, que lo traduzcan al español mas.
jaja, la silla "pairOn" es lo mejor para los programadores XP, jeje. Re chistosa la bromita, con su medidor de humor: desde Dijkstra hasta Ballmer.
Pero sip, hay que comentar, pero en lo posible evitar escribir c'odigos oscuros.
Ojala podamos ver un par de "pairOn" en la escuela de invierno
Saludos
Este es un muy buen tema y merece ser analizado con mayor detalle, aqui algunos comentarios.
por supesto esto de la silla es muy buena idea.....aunque creo que le falta cinturones de seguridad, para amortiguar las caidas del sistema.
Muy buena la comparativa del blog citado por Marcelo.
...Yo conozco algunos machotes que "dicen" poder escribir aplicaciones Java con sólo EMACS en un equipo de varios programadores y en una aplicación comercial grande. Pero no lo he visto con mis propios ojos.
#11, yo creo que te equivocas. Menos en lo del bloc de notas.
Por ejemplo, los que usamos linux como so 'unico o primario, no es "por creerse m'as". Bueno algunos si, pero en la mayor'ia linux tiene todo lo que uno necesita. Personalmente en windows me siento ineficiente y andando a tropezones hasta fofo.
Lo mismo con vim o emacs, bueno... emacs es un excelente SO solo que le falta un buen editor ;-)
Yo uso vi para todo, por que tiene todo lo necesario: autocomplementaci'on del mismo c'odigo o del api (7.*), coloreado de sintaxis, reglas de c'odigo para cada lenguaje, y much'isimo m'as que ser'ia d'ificil intentar explicarlo... por que es d'ificil explicar la "sensaci'on" a alguien que no lo ha probado.
En este blog tiene buenos ejemplos del poder de vim: http://amix.dk/blog/viewLabelPosts/5
No tendr'ian que quedarse con prejuicios de que "bloc de notas" es igual que vim/emacs y que solo sirven para escribir scripts o archivos de configuraci'on. Es como pensar que los javeros estan casi al final de la jerarqu'ia de programadores: http://www.anieto2k.com/2006/08/04/jerarquia-de-programadores/ ;-)
# 15. Creo responder asì es tipico cuando uno se siente herido :-). En todo caso, todos usaremos emacs o vim, y como dices es dificil explicar las cosas para alguièn q no ha desarrollado cosas grandes :), es como pensar q los serv... ..... No voy a entrar en discusiones q me harian perder tiempo, por cierto he probado vim, emacs, kyte y algunos otros, pero la verdad yo no me veo programando en estos, y pues no quiero tampoco q se confunda bloc de notas con estos editores, es cierto q son muy pontetes, pero como dije antes creo que hay herramientas para cada actividad que se quiera hacer, ahora si cada quien tiene su preferencia de quizàs ver en su maquina una ventana con lineas de comandos o una interfaz mucho màs amigable, pues eso depende de cada uno, donde se sienta màs còmodo y feliz, eso de decir q uno se siente fofo ... jeje . nunca me he sentido asi, quizàs para algunos es màs fàcil sentir algunas sensaciones ... en todo caso no quiero llevar eso hacia otro objetivo. Al punto: "Creo que es mejor utilizar herramientas apropiadas para cada tarea que se vaya a realizar, dependiendo de ello" Y pues como comentaba el post del Dr Pablo, "llego el comentador" asi que como tenemos una nueva herramienta que conocemos que existe serà buena probarla ... :).
Saludos al mundo linuxero, pronto volverè a estar en ese mundo. "a veces uno pasa por distintas situaciones que lo llevan a pasar por tonto para no dejar descubrir algunas cosas"