Por qué dejé de escribir comentarios en mi código

Durante años llené mis archivos de comentarios que explicaban qué hacía cada línea. Hoy los borro casi todos.

Un buen nombre de función dice lo que hace. Un comentario debería decir por qué: la restricción escondida, el bug que obligó a esa solución, el caso raro que nadie esperaba.

Cuando un comentario describe el qué, se pudre en cuanto cambia el código. Cuando explica el por qué, sigue siendo verdad mucho después.