Saltar al contenido
CONTACTO

Ley del comentario mentiroso

PROGRAMACIÓN Y BUGS

Cuando el comentario y el código no están de acuerdo, probablemente se equivocan los dos.

— Anónimo, folclore informático
VIDEO.EXE16:9

Los comentarios son las frases que los programadores dejan en el código para explicar qué hace. En teoría son un gesto de cortesía hacia quien vendrá después. En la práctica son como las señales de tráfico de una carretera que entretanto han cambiado de sitio.

El código se cambia, el comentario se queda. Así encuentras escrito «calcula el descuento del diez por ciento» encima de una función que manda un correo al director. ¿Quién tiene razón? Nadie. El comentario cuenta una intención antigua; el código, un accidente moderno.

Existe también la escuela de pensamiento contraria, la de los programadores orgullosos que nunca comentan: si costó escribirlo, que cueste entenderlo. Yo estoy en medio. Comento siempre, pero con frases como «no tocar». No explica nada, pero salva muchas vidas.