do you want it similar to this fashion?

https://matplotlib.org/stable/tutorials/index.html

What about expanding to second level? I landed on this issue b/c I was frustrated that I couldn't find the annotation tutorial because it's now buried under 3 levels.

@story645 For sure, https://matplotlib.org/devdocs/users/index.html and https://matplotlib.org/devdocs/users/explain/index.html should be fixed.

#24493 actually had a bunch of reasonable ideas. I think we should not over-stress about it, and just choose one and go with it. Nothing is perfect, and we will never get 100% consensus on these things, but most of the ideas in there were better than the status quo. If you wanted to pick one that was relatively comprehensive, we can try it for a while and tweak later. We should get something in soonish so we can live with it for a while before the release (Aug?)

FWIW, I like the idea of having graphics on these pages. There are lots of thumbnails already in the docs that we can use to visually guide the reader.

Was this addressed by #26110?

Yep!