organize navbar in overview->details order

[story645]

Um this is a first pass rather than something I'm strongly attached to, but I'm proposing the following story right to left because it goes from overview of the library to details on demand. I continue to not really know where to place tutorials but the middle kinda makes sense

• plot types -> user guide -> tutorials -> examples -> reference

[timhoffm]

Ok by me. But note that the User Guide page cuurently is more a global TOC and contains the others. By content I'd does not fit in an overview -> detail order. But that's a more general issue of our general sphinxpage hierarchy..

[story645]

By content I'd does not fit in an overview -> detail order. But that's a more general issue of our general sphinxpage hierarchy.

Agreeish but @jklymak especially has been putting a lot of work into making it more overviewish.

[timhoffm]

Agreeish but @jklymak especially has been putting a lot of work into making it more overviewish.

I know and appreciate that. We've had detailed discussions. At some point we decided to merge the current state. It's already much better than before. I'm just reminding that there is still work to be done. And the intended ordering of this PR is not yet reflected by the content behind the menu title "User guide".

[story645]

So the reason I put the order as user guide->tutorials is b/c of the getting started section of the user guide:

And the intended ordering of this PR is not yet reflected by the content behind the menu title "User guide".

I tried to make the overviewish nature clearer in matplotlib/matplotlib#24493 and I'd now probably advocate for some kinda top level table/roadmap that groups things into something like "Start->Build->Customize" + Project info + remove contribute since it's in the nav bar.

[story645]

Ping again on this? Especially since #26332 went in so the user guide is no longer global toc?

[QuLogic]

It looks like the User guide does seem overview-y now, so this seems good.