Documentation Link

https://matplotlib.org/stable/api/index versushttps://matplotlib.org/devdocs/api/index.html

Problem

There was some cleanup ofhttps://matplotlib.org/devdocs/api/index.html by@timhoffm in#26402, but I feel it went too far. For instance, there used to be a small plot on the API page to orient users as to the basic usage pattern. I find the current version very terse, and not helpful to new users. You can argue that an API page should be terse, however our API is actually pretty strange and subject to confusion, so I think getting users on the right path here is helpful.

Suggested improvement

• should at least include the small example again
• be a bit more verbose about the two APIs.
• includesubplot_mosaic on the same level assubplots.