René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Doc]: tutorials and user-doc organization...","articleBody":"The \"tutorials\" section of the docs is really mostly _not_ a tutorial, but long-form discussion of library features, and how the library works.  These are done using sphinx-gallery, which is quite convenient for writing docs with lots of plotting examples in them.  \r\n\r\nI would argue that much of the material in Tutorials should be considered part of the Users Guide, and organized in the TOC that way.  It's possible some of the \"tutorials\" could just be made rst files, and edited in rst going froward.  That would ideally require some sort of tool to \"run\" all the `.. plot::` directives in the rst without compiling the whole doc suite.  Such a tool would be generally useful as well, and shouldn't be that hard to make.  However, even leaving the \"tutorials\" as sphinx-gallery  python files may be fine if we organize them in the User Guide TOC.\r\n\r\n","author":{"url":"https://github.com/jklymak","@type":"Person","name":"jklymak"},"datePublished":"2023-01-06T20:58:24.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/24900/matplotlib/issues/24900"}