mootools / website

MooTools Website - move fast and break things
https://mootools.net
44 stars 31 forks source link

Order of components in Docs #185

Open timwienk opened 9 years ago

timwienk commented 9 years ago

The order of all components of a project in the Docs is currently alphabetically. In the old website the documented components were separated by subject and the order was manually set up. I don't know if this is something we'd want to bring back, but it does seem easier to use than the current alphabetic list.

If we want to bring it back, maybe a docs.yml or docs.json file in the project repo to facilitate this?

Example from Core docs from old website: docs-core

--- Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/5939443-order-of-components-in-docs?utm_campaign=plugin&utm_content=tracker%2F130405&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F130405&utm_medium=issues&utm_source=github).
lorenzos commented 9 years ago

+1. For me the old sorting is far more comfortable than the new one. That, by the way, is only partial alphabetically: it looks like Types and Utilities classes are places on the bottom (I guess because they are sorted by the words Types and Utilities instead of class names), and for me this partial sorting is absolutely confusing.

SergioCrisostomo commented 9 years ago

Should we add also the titles like Core, Types or Browser as in the image above (left aligned), or just fix the order of the components?