Le lecteur Eric O explorait le code source d'une API de gestion de la concurrence lorsqu'il est tombé sur un décalage révélateur entre documentation et réalité dans une propriété Status.

Le commentaire de documentation XML au-dessus de la propriété explique sérieusement que le statut est privé : l'objet lui-même doit pouvoir le définir, mais les consommateurs ne devraient pouvoir que le lire, sous peine de tout casser. La déclaration juste en dessous est pourtant publique — avec un getter et un setter publics, ce dernier se contentant de déclencher une notification PropertyChanged lorsque la valeur diffère du champ _status.

L'article concède que cela fonctionne probablement en pratique et que le commentaire apparaîtra au moins dans la documentation générée, suggérant discrètement que le setter est interdit. La chute repose sur l'hypothèse sous-jacente : que les utilisateurs de l'API liront réellement cette documentation — ou se soucieront qu'un membre franchement public prétende être privé.