¿Cuál es el mejor (peor) comentario que has visto en un código?

Eso fue lo que preguntaron en Stack Overflow y aun me estoy riendo de las respuestas. Y antes de que se me pase, estoy deseando leer los vuestros, los mejores (peores) comentarios que has visto en un código un fuente, por favor, déjanoslos en la sección de comentarios de esta entrada.
Yo te dejó aquí los mas curiosos que leí cuando salió el tema en Stack Overflow, alguno no tiene desperdicio…
 
// Dear maintainer:
// Once you are done trying to ‘optimize’ this routine,
// and have realized what a terrible mistake that was,
// please increment the following counter as a warning
// to the next guy:
//  total_hours_wasted_here = 42
 
// Querido
// Una vez que haya tratando de «optimizar» esta rutina,
// y se haya dado cuenta del terrible error que era,
// por favor, incremente el siguiente contador como advertencia
// al que venga después:
// total_horas_gastadas_aqui = 42

//When I wrote this, only God and I understood what I was doing
//Now, God only knows
 
// Cuando escribí esto, sólo Dios y yo comprendíamos lo que estaba haciendo
// Ahora, sólo Dios lo sabe

Este es de un especial “cariño”, es el típico de código generado con herramientas tipo MDD…
// Autogenerated, do not edit. All changes will be undone.
// Autogenerado, no editar. Todos los cambios se perderán

// I dedicate all this code, all my work, to my wife, Darlene, who will
// have to support me and our three children and the dog once it gets
// released into the public.
 
// Le dedico todo este código, todo mi trabajo, a mi esposa, Darlene, quien tendrá
// que apoyarme a mí y nuestros tres hijos y al perro apoyar
// una vez que esto haga público.

// Magic. Do not touch.
// Mágico. No tocar.

// Replaces with spaces the braces in cases where braces in places cause stasis     $str = str_replace(array(«\{«,»\}»),» «,$str);
//Remplazar con espacios las llaves….

0 comentarios en “¿Cuál es el mejor (peor) comentario que has visto en un código?”

  1. Supongo que en un futuro este comentario que voy a escribir podría pasarme factura laboral si lo encontrase un futuro empleador, pero me gustaría compartir el «mejor» comentario que he escrito a lo largo de mi carrera:
    /**
    * Estimado programador:
    * En el futuro mantendrás este código «ad hoc» y es posible que
    * no entiendas nada. Me odiarás y pensarás que fui poco
    * profesional. A mi me dijeron que lo hiciera rápido para
    * poder entregar el proyecto a tiempo y que después se tiraría.
    * Sospecho que al final eso no se cumplirá.
    *
    * Cuando leas esto puede que no trabaje aquí. Por eso, te dejo
    * las siguientes notas para ayudarte a entender las
    * optimizaciones y las reglas de negocio que van incluidas:
    *
    … y su explicación correspondiente, que es larga.

  2. A mi me hacen gracia los tipicos //De momento, //Temporalmente, etc… que tienen más de cinco o seis años.
    De hecho siempre que me descubro diciendo o pensando un «De momento…» me saltan las alarmas y automaticamente se que me estoy endeudando.
    Saludos!

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Share This
Ir arriba