That’s a huge list of features! Have you used any code documentation systems that provide all of these? Could you show some examples?
Currently there’s a lot of new work being done on the official OCaml documentation generator called odoc. In fact it’s already being used by a large and growing number of packages. The system is built so that you can generate the package documentation locally from your machine (see how to acheive this with odig).
Unfortunately not everything you enumerated is currently implemented in odoc. Fuatures like search, plugin extensibility and markdown support are not present. But we are working on adding some of those. Here is a preview of a new visual theme with some of the features you asked for.
Does that look “user-friendly”? Let us know what you think.
That’s a huge list of features! Have you used any code documentation systems that provide all of these?
I know that. It is a list of features that are wanted by me, but many of them are not mandatory. Ruby, for example has two pretty good tools: https://yardoc.org and GitHub - zzak/sdoc: Standalone sdoc generator and if OCaml has something similar to those two - it would be enough to me.
Does that look “user-friendly”? Let us know what you think.
A lot of effort is being put into improving the doc tools at the moment, but more assistance would be very welcome. You could help add the features you feel are missing.