El lector Eric O revisaba el código fuente de una API de manejo de concurrencia cuando se topó con una reveladora discrepancia entre documentación y realidad en una propiedad Status.

El comentario XML de documentación sobre la propiedad explica con seriedad que el estado es privado: el propio objeto necesita poder establecerlo, pero los consumidores solo deberían poder leerlo, no sea que todo se rompa. La declaración justo debajo, sin embargo, es pública — con getter y setter públicos, donde el setter solo lanza una notificación PropertyChanged cuando el valor difiere del campo _status.

El artículo admite que en la práctica probablemente funciona y que el comentario al menos aparecerá en la documentación generada, insinuando que el setter está prohibido. El remate está en la suposición de fondo: que los usuarios de la API realmente leerán esa documentación — o les importará que un miembro claramente público solo afirme ser privado.