meilisearch / documentation

Meilisearch documentation
https://docs.meilisearch.com
MIT License
146 stars 241 forks source link

Rename `Learn` section #1305

Open guimachiavelli opened 2 years ago

guimachiavelli commented 2 years ago

Once #1304 is merged, we will have two main links in our top nav:

In combination with #1294, #1304 greatly increased the breadth of content under the Learn heading, to the point it is an awkward description that doesn't really give users a good understanding of what they'll find in that section.

We should rename it to something more descriptive. Let's gather some ideas here and discuss/vote on them later.

Current suggestions:

bidoubiwa commented 2 years ago

I like guides, I think it is the most known and also very clear in what you are going to find inside

dichotommy commented 2 years ago

Some sites refer to their non-API documentation as just "docs", e.g. on Stripe's API reference, you click a button that says "Docs" to return to the main site.

I don't like it as much as "guides" since it can be confusing—isn't everything on the docs site documentation? 🤔—but I like that it's a little more vague than "guides". I worry that "guides", while pretty vague, is still a little too specific to encompass everything outside of the reference.

In any case, I think "guides" is our top candidate at this point, and would probably be a good start. We can always refine it later.

bidoubiwa commented 2 years ago

Yes I agree, sometimes I see docs as well and you are right it is quite confusing. Unless it is on their main website but then you are redirected to a docusaurus/vuepress like website in which everything becomes doc. Guide seems to be a good start while maybe not the perfect one yet

maryamsulemani97 commented 2 years ago

I noticed that many websites with a "Guides" section have a "Quick Start"/"Getting Started" section as well. Examples:

Maybe we could go with this?

guimachiavelli commented 1 year ago

@dichotommy, I think this could a good and relatively simple to do. Perhaps something we can discuss in the next Docs restructure meeting?

curquiza commented 1 year ago

Discussed with @guimachiavelli We want to have more information about devhub before knowing what do to with this issue. We indeed want to rename the section but we need to know more about devhub to make a decision