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.
via:dosideas.com