Los comentarios en el código fuente son una buena forma de documentar la intención... aunque a veces se abusa, y se convierte más en un diario de viaje o un blog donde se van dejando opiniones, frustraciones y quejas. Y es que, suele ocurrir, los comentarios en el código pueden convertirse en un reality show del desarrollo del producto.

Compartimos a continuación un compilado (chiste chiste) con los mejores comentarios en el código fuente. ¿Qué comentarios graciosos recuerdan ustedes?

Me siento ignorado

// a veces creo que el compilador ignora todos mis comentarios

Sinceridad

// estoy borracho, lo arreglo después

Un poco de magia

// Mágico. No tocar. 

Por si no se entiende

return 1;  //retorna 1

Disculpas...

// lo siento.

Dios, ayúdanos

// Cuando escribí esto sólo Dios y yo sabíamos lo que hace.
// Ahora, sólo Dios sabe.

Aviso

/* 
 * Quizás creas que sabés lo que hace esta porción de código.
 * Creeme, no lo sabés.
 * Si tratás de entenderlo vas a pasar muchos horas sin dormir,
 * maldiciendo el momento que pensaste que eras los suficientemente
 * inteligente para "optimizar" el siguiente código.
 * Así que, cerrá este archivo y andá a jugar con otra cosa.
 */

Advertencia para al mantenedor

// 
// Querido mantenedor: 
//
// Una vez que termines de intentar "optimizar" esta rutina,
// y que te des cuenta del terrible error que cometiste,
// por favor incrementá el siguiente contador como una
// advertencia para el próximo:
//
// total_de_horas_gastadas_aqui = 16
//

¡Que no ocurra!

try {

} finally { // no debería ocurrir

}

Desconfiar de la documentación

/**
 * Siempre devuelve true.
 */
public boolean isAvailable() {
    return false;
}

Arreglo

// no estoy seguro de que esto funcione, pero resuelve el problema

Desafio

// el código siguiente reemplaza al código anterior. ¿¿Algún problema??
// Si. No funciona.