dask / dask-sphinx-theme

Sphinx theme for Dask documentation
BSD 3-Clause "New" or "Revised" License
6 stars 15 forks source link

Drop the navbar #89

Open mrocklin opened 3 months ago

mrocklin commented 3 months ago
Screenshot 2024-05-28 at 7 59 58 AM

The current navbar has links to pages that I think mostly don't matter.

The only link I actually think is highly valuable there is the "Dask" link, which will bring people back to the main docs if they're on a subproject site (like dask-jobqueue). That could probably be managed through an image/link on the top of the left-sidebar.

I'm also open to new links if people have ideas. If we can't find a good list though then I think it's good to focus peoples' attention on the TOC.

cc @scharlottej13 @jacobtomlinson @jrbourbeau

mrocklin commented 3 months ago

Trying to be constructive, some core pages:

  1. dask
  2. dataframes
  3. arrays
  4. deployment
  5. Social icons (youtube, social, slack, team (which goes to the community page))
scharlottej13 commented 3 months ago

Yeah, I definitely don't use the links in the top nav to get to places I want to go. Maybe examples, but as you've mentioned it doesn't get great engagement. From looking at hotjar it seems like people are also more likely to rely on the left TOC too (this is for https://docs.dask.org/en/stable/)

Screenshot 2024-05-30 at 6 09 43 PM

Trying to be constructive, some core pages:

  1. dask
  2. dataframes
  3. arrays
  4. deployment
  5. Social icons (youtube, social, slack, team (which goes to the community page))

and github?

I was also looking at other docs for inspiration and many of them (eg polars, prefect, xarray, rapids) all have a pretty minimal top nav and seem to primarily rely on the left TOC.