Leyendo el blog de Ramon Leon encontré un excelente artículo listando algunas de las aberraciones que he encontrado en el código que he tenido que modificar y algunos que yo, me da pena decirlo, use en algún momento, como poner prefijos a las variables para indicar su tipo (la culpa es de Pascal). Algunas citas memorables, enfatizado por mi: Don’t comment closing tags.

if(foo == bar){
//bunch of code
//bunch of code
//bunch of code
//bunch of code
//bunch of code
//bunch of code
//bunch of code
//bunch of code
//bunch of code
//bunch of code
//bunch of code
//bunch of code
//bunch of code
} //end if(foo == bar)

this is beyond ignorant, you should be shot. ¡Ja ja, nada más cierto! O, dirigido al mundo de Java: XML is for configuration files and data transport, not for general purpose programming. Para alegrarse el día