Cuando programo en PHP y se me forman secuencias de if’s bastante largas suelo poner un comentario que una vez encontré en un archivo de WordPress: “Si borras esta línea el cielo caerá sobre nuestras cabezas”. Por lo general esa línea es } (una llave).

Ahora me encontré con gente que hace mejores comentarios en sus programas:

Sinceridad

// estoy borracho, lo arreglo después

Un poco de magia

// Mágico. No tocar.

Por si no se entiende

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.

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.
*/

Arreglo

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

Ah decir verdad el del capitán obvio lo suelo usar bastante.

Vía: El libro gordo de petete.