Description
Summing up the key points from #438...
As we continue our work on #1258, #1386, and the others mentioned in #1380, we can, and have already, started talking about better ways to group, consolidate, and improve the flow of pages within this site. This should be started by simply sorting the pages within each section, but, once we've done that, we could likely group sections within the sidebar (as suggested by @pastelsky in #438) or add another layer of navigation.
Here's the checklist of TODOs:
- Sort all existing pages in an intuitive way (already done for guides, see Guides - Review and Simplify #1258)
- Support, Development, and maybe sponsors/backers => Contribute (Consider renaming the "support" page #1365)
- CLI nav link should be removed (it will instead just be found under API)
- The articles should then be organized via nested directories or a
groupfield. - Top level pages should use a wider layout (e.g. Comparison is hard to read #1367)
Certain infrastructure changes should make some of this much easier. Specifically the fact that in newer versions of Antwar as well as in Phenomic and Gatsby -- routing is automatically synchronized/based on the structure of the /content directory. This means far less configuration and a more intuitive repository. This has already been started in #980 with some antwar/webpack updates.
See the proposed nesting levels in this comment. As mentioned above, a group field in the YAML frontmatter would also help us achieve this but wouldn't be reflected in the routing structure.