René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[MNT]: Idea to accelerate docs contributions with `Build changes only docs`.","articleBody":"### Summary\r\n\r\nContributing small docs changes has one bottleneck in my perception: CircleCI takes LONG to build new changes in examples.\r\nWhen I execute the python script locally, it takes about 0.2 seconds.\r\nThe CircleCI docs build takes more than 30 minutes.\r\nI know that the sphinx rendering must also take some seconds, but it would be amazing if there was a way to bring the build time down to e.g. only 1 minute by only rendering relevant parts of the docs.\r\nThis could accelerate the review process a lot.\r\n\r\n### Proposed fix\r\n\r\nHere is an idea: Only nodes that connect to green lines are rendered, everything else is ignored.\r\n\u003cimg width=\"500\" alt=\"image\" src=\"https://user-images.githubusercontent.com/44469195/166198919-0213b8aa-1abf-4fd2-b71f-81d60b691faf.png\"\u003e\r\n\r\nIn a pull request, it can look like this: In every new commit, the (not yet existing?) GitHub action `Build changes only docs` is triggered.\r\nThis action will execute the above diagram.\r\n\r\nFor the current complete docs build with CircleCI, I see two options:\r\n1. It could be additional active all the time.\r\n2. It could be activated after the iteration phase in the last commit, to make sure that the whole docs build without error.  This activation could be triggered e.g. when a pull request is getting the \"Approved\" status, or when there is a certain keyword in the commit. I would prefer the later one, as this saves resources.\r\n\r\nNote, that this is issue is not a Matplotlib specific, but also applies to other rendering intensive docs like `napari`, `manim` and  `scikit-image`.","author":{"url":"https://github.com/kolibril13","@type":"Person","name":"kolibril13"},"datePublished":"2022-05-02T07:20:33.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":8},"url":"https://github.com/22956/matplotlib/issues/22956"}