La sección «Representative Line» de The Daily WTF presenta un comentario de documentación enviado por el lector Mark W., descubierto en una base de código que él describe como por lo demás muy bien escrita y de más de 100.000 líneas.
Todo el comentario XML de la función en cuestión dice: «Does something wonderful.» Esa es la especificación completa — sin parámetros explicados, sin comportamiento descrito, solo una promesa de maravilla.
La columna señala la ambigüedad: ¿es maravilloso tipo «magia navideña» o el sarcástico «qué maravilloso por ti»? El tono no sobrevive al texto plano, así que los futuros mantenedores solo pueden adivinar.
Mark admite que la línea no es representativa de la base de código en conjunto — pero, concluye el artículo con sequedad, ciertamente representa esta sección maravillosamente.
Comentarios
Aún no hay comentarios — escribe el primero.
Inicia la conversación
Sin cuenta ni contraseña — introduce tu correo y te enviamos un enlace de acceso de un solo uso. ¿Primera vez? Todo se configura automáticamente.
Tu valoración se aplicará automáticamente al iniciar sesión.
Revisa tu bandeja de entrada
Hemos enviado un enlace de acceso a …. Ábrelo en este dispositivo — esta pestaña te conectará automáticamente.
Esperando tu clic …
·