Great 
We’re actually going to rewrite all the docs (or just write them, for the many parts that are missing): https://github.com/ocsigen/lwt/projects/2. As you could probably guess from the number of items in the project, it’s going to take a while…