Re:State of Multicore OCaml [pdf]
by nobleach on Thursday June 28, 2018 @03:05PM
(#17419589)
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.
[ Parent
| on HN ]
Re:State of Multicore OCaml [pdf]
by ZirconiumX on Friday June 29, 2018 @06:00AM
(#17423547)
OCaml 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.
That sounds interesting, thanks!
It'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 THAT is decent documentation.