DOC: mark mosaic as no longer provisional - #24891
Conversation
Co-authored-by: Jody Klymak <jklymak@gmail.com>
jklymak
left a comment
There was a problem hiding this comment.
If you search for "mosaic" on the rendered docs example page, you do not get this example showing up. I think folks wanting a quick guide as to how subplot_mosaic works will want that in the title.
oscargus
left a comment
There was a problem hiding this comment.
Should there be some sort of release note for this? It may make sense for users to know that this has happened in another way than noting that the provisional note has been removed.
Within the tutorials, I prefer the subject categories (Colors, Text) to the basic/intermediate/advanced categories. The subject links help me navigate to the thing that I currently want to learn about, whereas I don't know the difficulty level of the thing until I've learned it. I wonder if we could make a "layouts" tutorial category for mosaic, constrained layout, tight layout and "arranging multiple Axes in a Figure". I appreciate that that is a little out of scope for this PR though. |
|
If we use the terminology from https://documentation.divio.com/tutorials/ then this is not a tutorial because it is just N related examples all on one page. To riff on their cooking analogy, this is a list of every way to cook and egg not instructions on how to make a nice omelette breakfast. Under this rubric I think many of the things currently in tutorials are miss-categorized (https://matplotlib.org/stable/tutorials/introductory/lifecycle.html and maybe the image one may be the only ones that actually fit the divio definition). Good point about the release notes, I'll add that. |
a27fa2b to
0bc10e9
Compare

PR Summary
Mark mosaic as no longer provisional.
I also moved this from tutorials -> examples as this is much a how-to and "gallery" is what we have that matches the divio "how-to" best.