La rubrique « Representative Line » de The Daily WTF présente un commentaire de documentation soumis par le lecteur Mark W., découvert dans une base de code qu'il décrit comme par ailleurs très bien écrite et dépassant les 100 000 lignes.
L'intégralité du commentaire XML de la fonction en question se résume à : « Does something wonderful. » C'est toute la spécification — aucun paramètre expliqué, aucun comportement décrit, juste une promesse de merveille.
La chronique souligne l'ambiguïté : s'agit-il du merveilleux « magie de Noël » ou du « comme c'est merveilleux pour toi » sarcastique ? Le ton ne survit pas au texte brut, laissant les futurs mainteneurs dans la devinette.
Mark concède que la ligne n'est pas représentative de l'ensemble de la base de code — mais, conclut l'article avec sécheresse, elle représente certainement cette section à merveille.
Commentaires
Pas encore de commentaire — écris le premier.
Lance la discussion
Pas de compte ni de mot de passe — saisis simplement ton adresse e-mail et nous t’envoyons un lien de connexion à usage unique. Première visite ? Tout se met en place automatiquement.
Ton évaluation sera appliquée automatiquement après ta connexion.
Vérifie ta boîte mail
Nous avons envoyé un lien de connexion à …. Ouvre-le sur cet appareil — cet onglet te connectera automatiquement.
En attente de ton clic …
·