ETA: Following @timhoffm's suggestion, this pulls the tutorial content guidance from #26389 into this PR so it can be evaluated in conjunction with a rework of the index page.
removes the links to the individual user guide documents because cross listing those documents as user guide pages and tutorials makes it very unclear what we consider a user guide versus a tutorial -> which hurts both:
discoverability -> it's unclear what sorta content is supposed to be on a page so hard to build intuition on what should be there
contributing -> it's unclear what kinda of contributions would be acceptable because the pages don't have a clear identity
replaces the custom gallery code with a gallery listing. In theory we can just go back to a readme page, but this (uses an unreleased feature of sphinx so requires a release, am adding dev here just to demo what page would look like)
moves the donut page to tutorials because it's showing a couple of things: how to make a donut chart and also how to annotate it - in an explanatory linear manner, talking the reader through each stage of the process. That's roughly the delineation between tutorial and example/how-to according to diataxes(https://diataxis.fr/tutorials/)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
ETA: Following @timhoffm's suggestion, this pulls the tutorial content guidance from #26389 into this PR so it can be evaluated in conjunction with a rework of the index page.
In summary, this PR: