reasonml / reason-tools

Adds Reason to the browser

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Odoc-generated pages aren't very readable

glennsl opened this issue · comments

See: https://ocaml.janestreet.com/ocaml-core/latest/doc/core/Std/Option.mod/


Edited to add:

For comparison:

2017-02-10-231906_252x118_scrot

2017-02-10-231929_274x131_scrot

It is much easier to scan the original page for the function you are interested in.

Are you referring to the accordion feature specifically? Or do you think everything looks bad?

Sorry for being so vague! What I meant is that it is much easier to quickly scan the original page to find a specific function.

For comparison:

2017-02-10-231906_252x118_scrot

2017-02-10-231929_274x131_scrot

This page is apparently generated by odoc. Lots more examples at https://ocaml.janestreet.com/ocaml-core/v0.9/doc/ and http://docs.mirage.io/