documentation
documentation copied to clipboard
Replace advanced topics in the sidebar
~~Async operations, security & permissions, and updating Meilisearch are the most important "advanced topics" that users may not actively search for. The rest are search feature guides, and probably deserve their own subsection.~~
Edited: 2022-10-04
The "advanced topics" category in the "Learn" sidebar has become a bit of a content grab-bag, making it hard for users to find what they need by browsing. More generally, the large amount of content and multiple levels of nesting in the sidebar risk making the site feel overwhelming, which could have an adverse effect on our users.
It would be nice if guides such as "Filtering and faceted search", "Geosearch", and "Sorting" could be grouped together somehow, as all describe essential Meilisearch features—none of which are particularly advanced. It is also worth asking what is gained by making "Data backup" and "Inner workings" sub-sections of "Advanced topics" in the sidebar instead of letting them stand on their own. Odd ducks like Updating Meilisearch and Asynchronous Operations continue to be difficult to place, as they are essential to using Meilisearch long-term but could discourage completely new users.
Ultimately, we will need to think deeply about what kind of content organization makes the most sense for us. Would we prefer organization by topic (e.g. "Security and permissions", "Data backup", "Inner workings"), organization by experience level (e.g. "Getting started", "Core concepts", "Advanced topics"), or some other form of organization?
Doing some kind of direct observation/testing of first-time documentation users could go a long way towards helping us understand the categories that users would find helpful + intuitive.