Repository navigation
[Doc]: users/explain bare index looks bad #25493
Description
Documentation Link
https://matplotlib.org/devdocs/users/explain/index.html
Problem
This is very bare bones, and could be substantially improved
- figures?
- A bit of introduction to what the section is meant to do.
- visual elements for the different sections?
Suggested improvement
No response
Activity
Higgs32584 commented on Mar 30, 2023
do you want it similar to this fashion?
https://matplotlib.org/stable/tutorials/index.html
story645 commented on May 29, 2023
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.
jklymak commented on May 30, 2023
@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.
rcomer commented on Jul 1, 2023
Was this addressed by #26110?
jklymak commented on Jul 1, 2023
Yep!