5 ms·
Phew, I thought you were talking about the ecosystem as it refers to docs. The docs for OCaml and the Core library are so absolutely terrible. It's like 1996 th
by nobleach 8y ago
Phew, I thought you were talking about the ecosystem as it refers to docs. The docs for OCaml and the Core library are so absolutely terrible. It's like 1996 threw up in an HTML doc and no one has thought to change any of it. Sadly, ReasonML is taking the same road. Elixir on the other hand has some great documentation. I'd love to see some work done on OCaml's standard library docs so that they had more in the way of examples.
- deleted 8y ago[deleted]
- xvilka 8y agoCheck https://dev.realworldocaml.org/ https://dev.realworldocaml.org/
- nobleach 8y agoIt's a wonderful book. I own a paper copy of the first edition. I know there's a second edition coming. It isn't a substitute for api docs... at all. Take a look at this: https://doc.rust-lang.org/std/vec/index.html https://doc.rust-lang.org/std/vec/index.html THAT is decent documentation.
- ZirconiumX 8y agoOCaml has odoc now, which is what creates the Core web page. Core does have bad documentation, but you can try Containers, which is much lighter and better documented, but less featureful.
- nobleach 8y agoThat sounds interesting, thanks!