Barrapunto

De un código sin comentarios se puede saber lo que hace, pero de un código con buenos comentarios se debería poder extraer lo que tiene que hacerse (cuál es o debería ser su función, sin atender al método usado), teniendo la solución propuesta e implementada por el anterior programador delante. Esto hace a los bloques de código susceptibles de ser cambiados, mejorados, reestructurados o eliminados a conveniencia del programador sin incurrir en problemas no previstos.

Por tanto, no pondrás:
v += 2;

ni:
v += 2; # sumo 2 a la variable w

sino:
v += 2; # para acelerar la búsqueda siguiente

Otra persona podría ver ese código y pensar que si cambia de algoritmo no es necesario sumar nada y la búsqueda no se ralentiza. Si el comentario no existiera, no sabría el papel que tiene la operación dentro del conjunto y tendría que averiguarlo primero si quiere poder verificar o modificar el código.

____Lameness filter encountered._____
Tu comentario ha violado el filtro de compresión "postercomment". Prueba con menos espacios en blanco y/o menos repeticiones . Comentario detenido. //Problemas con el copy&paste del GVIM al Firefox//