sábado 30 de mayo de 2009

Comentarios para tu código

Los comentarios… esas líneas que nunca pongo en los códigos, y que causan que tenga que perder varios minutos al otro día para "re-entender" que carajos quería hacer con el código … Así que a partir de hoy lo haré… no por ti, no por mi, sino porque por lo regular esos minutos se convierten en horas, ya que si a los 2 minutos no he hecho nada, me pongo a jugar alguna pendejadilla que encuentre…

En fin, si no tienes idea de como poner los comentarios (w8… ¿no sabes cómo poner comentarios y dices que sabes programar?!), estos "layouts" pueden servirte para darte una idea…

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 [reí como 5 minutos con éste xD]
return 1; //retorna 1

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

Disculpas
// lo siento.

Aviso
/*
* Quizás creas que sabes lo que hace esta porción de código.
* Créeme, no lo sabes.
* Si tratas 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 cierra este archivo y ves 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 incrementa 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.

Museo
// se mira pero no se toca

El resentido:
// Hago esto en mi último día en el trabajo
Como me gustan este humor, que sólo los que estudiamos/trabajan en algo relacionado con la informático entendemos

Vía | Gran-Angular

0 Comentarios: