¿Ha habido alguna inversión valiente en documentación para software o lenguaje de programación?

Nadie invierte en documentación simplemente porque ningún cliente paga por la documentación. Simplemente lo esperan como parte del producto. Los clientes lo quieren y quieren alta calidad, pero definitivamente no es un artículo rentable. Puede desagregarse del producto primario y mostrarse como una línea de pedido separada, pero aún así no obtendrá un beneficio significativo.

Recuerdo cuando estaba en la universidad que solía haber enormes manuales para mainframes y sistemas Unix. Re. la documentación de Unix, básicamente era una copia impresa de las páginas del manual. En ambos casos, la documentación era tan masiva que el “libro” estaría encuadernado en una estructura metálica, y tenía que colocarse en una mesa como referencia. Esto no era algo que pudieras extraer de las pilas, sin dividirlo en un montón de volúmenes.

El lenguaje / sistema Smalltalk estaba muy documentado, hasta el nivel de VM. Se dividió en 4 volúmenes. Cada uno de ellos se identificaba comúnmente por el color de la portada del libro: Libro Azul, Libro Verde, Libro Rojo, Libro Púrpura.