¿Cuál es el mejor comentario de código que hayais encontrado?
Con esta pregunta tan simple hubo tal cantidad de respuestas que uno de los administradores del sitio, Jeff Atwood, tuvo que bloquear el hilo y poner una nota en la cabecera del hilo que decía:
Esta pregunta existe porque tiene importancia histórica, pero no se considera una pregunta relevante en este sitio web, así que por favor no la useis como prueba o evidencia para volver a hacer preguntas similares aquí
/* OK; before you read the following code know what I am trying to do. I needed to get the list of child catagories from the root node so that the root node didn’t appear in the selection box. But for some stupid fucking reason the stupid fucking DBA wont let me access the items using indices and I instead have to use their stupid fucking Iterator implementation. So there. */
$firstList = $this->getRootNode()->getChildren();
foreach ($firstList as $node)
{ $nodes = $node->getChildren(); break; // wtf?
}
Traducción: “OK; antes de que leas el siguiente código fuente debes saber qué estoy intentando hacer. Necesitaba obtener la lista de categorías hijas del nodo raiz de forma que el nodo raiz no apareciese en la lista de selección. Pero por alguna estúpida jod*** razón el jod*** DBA no me dejó acceder a los elementos usando los índices así que tuve que usar su estúpida implementación de Iterator. Aquí queda.”
// if i ever see this again i’m going to start bringing guns to work
Traducción: “Si vuelvo a ver esto de nuevo voy a empezar a traer pistolas al trabajo”
//hack for ie browser (assuming that ie is a browser)
Traducción: “Truco para el navegador IE (asumiendo que IE es un navegador)”
/**
For the brave souls who get this far: You are the chosen ones,
the valiant knights of programming who toil away, without rest,
fixing our most awful code. To you, true saviors, kings of men,
I say this: never gonna give you up, never gonna let you down,
never gonna run around and desert you. Never gonna make you cry,
never gonna say goodbye. Never gonna tell a lie and hurt you. */
Traducción: (Realmente este es complicado de traducir sin que pierda la gracia) “Para las almas valientes que han llegado hasta aquí: Vosotros sois los elegidos, los caballeros valerosos de la programación que trabajais duro, sin descanso, corrigiendo nuestro peor código. A vosotros, verdaderos salvadores, reyes de hombres, os digo esto: (letra de Never Gonna Give You Up, de Rick Astley“, lo que viene a ser un Rickroll en toda regla)
//
// 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 = 16
//
Traducción: “Querido mantenedor: Cuando hayas terminado de intentar “optimizar” esta rutina y te hayas dado cuenta de que hacerlo era un gran error, por favor, incrementa el siguiente contador como aviso al siguiente mantenedor que le toque: total_horas_desperdiciadas = 16”
// no comments for you
// it was hard to write
// so it should be hard to read
Traducción: “No hay comentarios de código para ti. Fue duro programarlo. Debe ser duro entenderlo.”
// I will give you two of my seventy-two virgins if you can fix this.
Traducción: “Te daré dos de mis setenta y dos vírgenes si consigues arreglar esto.”
// I am not responsible of this code.
// They made me write it, against my will.
Traducción: “No soy responsable de este código. Me hicieron escribirlo en contra de mi voluntad.”
//Dear future me. Please forgive me.
//I can’t even begin to express how sorry I am.
Traducción: “Querido yo en el futuro. Por favor, perdóname. No puedo siquiera empezar a expresar cuando lo siento.”
// 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
