Open vasco3 opened 4 years ago
Which sidebar items are you referring to? The docs follow a certain narrative, for the API module items it follows the order of the document body
this one
and this
for example, I wanted to know if List had a filter
method. So I had to search with Cmd-F
because List has many methods and they aren't sorted. If they were by alphabet then i could just skim to the methods starting with F and that way be more efficient.
I see, yeah that is a good idea. The index data is generated from the scripts/extract-indices.js
script.. we will consider this when building the odoc json extraction tool. I'd also accept a PR that modifies the before mentioned extraction script
Update: we are currently in the process of generating the API docs from the actual BuckleScript modules via odoc. We will implement the sidebar ordering there.
awesome!
The sidebar menus would be easier to read if they were ordered alphabetically. Also it would help to spot duplicates.