readthedocs / website

The Read the Docs community website
15 stars 5 forks source link

Navigation: convert About navigation to a dropdown #176

Closed agjohnson closed 2 months ago

agjohnson commented 1 year ago

From #174 and chat conversations, the current "About" navigation link should be something clearer, while retaining the flow of the top navigation menu. The best option is likely making "About" a dropdown, and most likely renaming the menu title to a more specific phrase like "Product".

agjohnson commented 11 months ago

cc @ericholscher

This was the original plan for the menu item that was renamed to "Features". I'm still ±0 on "Product", but there is probably another word that fits well here too.

But I think even if we stick with "Product" the menu could be:

Product:
  - How Read the Docs works (this is the current "features" page, but was meant more as a overview page originally)
  - Features:
    - Building
    - Pull request previews
    - Authentication
    - etc
  - Supported tools:
    - Sphinx
    - Mkdocs
    - Unofficial tools

I think this helps solve focus of the existing "features" page and still gives us a reasonable menu item name for the top navigation. It also opens up the door to expanding navigation a great deal

ericholscher commented 11 months ago

Yea, I agree. This is a great place to focus on additional content 💯

Though I'd do s/Unnofficial/Custom or similar for marketing purposes :)

agjohnson commented 11 months ago

Started a draft PR at https://github.com/readthedocs/website/pull/221 but I didn't play around much with the content structure too much yet. It needs icons probably and the mobile menu is a bit broken by this too. Just putting it up for now as I end my day.

ericholscher commented 5 months ago

Good example here: https://www.cerbos.dev/

agjohnson commented 4 months ago

Yeah, this is a fairly common pattern, here are some others:

To continue this work: