3 ms·

I've not been deeply involved in either so take my hunch for what it is: OCaml is an academic language like Haskell. Academics tend to neglect documentation in

I've not been deeply involved in either so take my hunch for what it is: OCaml is an academic language like Haskell. Academics tend to neglect documentation in general, be it because what they're working on is mostly self-serving, lack of time/enthusiasm or a tinge of elitism on that "this should be obvious and if not just read the code". Rust adherents seem to really want to take over the world and they realize that great documentation is an enabler for that. Also the standard libraries and compiler set a pretty strong precedent.

yawaramin 6y ago
Disagree, somewhat. You should check out the OCaml manual: https://ocaml.org/releases/4.11/htmlman/ https://ocaml.org/releases/4.11/htmlman/ It is a complete and up-to-date manual of the entire OCaml distribution, including executables, language, runtime, and standard library. It's rare to find modern industry-driven languages with this level of coherent documentation. But regarding third-party library documentation, that is indeed spotty. Some people publish it, some don't. I have to reluctantly conclude it's due to a lack of tooling which automates the tedious processes.