Expanding ocaml appeal to future open source application developers

[yawaramin]

We recently had a pretty big discussion on documentation: "Diátaxis" documentation structure

In general, yeah agreed, package docs sorely need usage examples.