Thanks a lot Emile for the valuable feedback! And for your help on odoc 3.
I’ll try to fix those issues before we merge then. (About the “visual” comments I have a disclaimer: I’m very not a designer, so I’ll do my best but … if anyone wants to help with a PR?)
This does not look very good because its multi-line. Also the color highlight is not part of the color scheme which makes feel it a little off.
I’ll see what I can do!
Cmdliner seems to lack sources: https://staging.ocaml.org/p/cmdliner/1.3.0/doc/cmdliner/Cmdliner/Cmd/Exit/index.html.
For a package to have source displayed, it needs to install the .ml. dune does this by default, so most packages get rendered sources. However I don’t think @dbuenzli’s packages do that. I don’t know if that is a choice to avoid having users depend on implementation details?
The sidebar has this small issue where the toplevel module is not being open by default:
As you point out, it’s hard to make the sidebar look good on most cases…
Its 88 chars wide, maybe the source view could accommodate up to 120 ? I am not sure there is a great solution here.
Surely we can improve things here.