René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Speeding up the Docs / Docs CI job","articleBody":"# The short story\r\n\r\nI think the Docs CI job can be faster, which would improve the contribution and review experience.\r\n\r\n# Long version\r\n\r\nIn the documentation team meeting we've been talking about a few workflow improvements. The [Docs / Docs CI job](https://github.com/python/cpython/actions/workflows/doc.yml) is quite slow, taking around 15-20 minutes. From some quick testing, it seems this is largely due to that we use Python from HEAD and build Python in the job[^1], rather than a build with optimisation etc. Tests of my speed-up patch reduce the core docs job to ~3m15s[^2].\r\n\r\nAs a reviewer, a green tick is a quick signal that the syntax of the documentation is probably correct, and I don't need to be as thorough, whereas if the build fails I can look in the logs and point out the error and a potential fix to the proponenet of the PR.\r\n\r\nI would suggest moving to `actions/setup-python` for the Docs job, but I don't know if there's been prior discussion[^3] on this that I haven't been able to find, or if there are other reasons it makes sense to trade off speed for building Python from HEAD.\r\n\r\nA\r\n\r\n[^1]: https://github.com/python/cpython/actions/workflows/doc.yml\r\n[^2]: [Patch](https://github.com/AA-Turner/cpython/commit/0ebc3933c27f6c2c4cbd9ad164519591234ea909), [Run 1](https://github.com/AA-Turner/cpython/actions/runs/2453898925), [Run 2](https://github.com/AA-Turner/cpython/actions/runs/2453918261), [Run 3](https://github.com/AA-Turner/cpython/actions/runs/2453977246).\r\n[^3]: #435 discusses not building Python, but in the context of reusing another build from HEAD rather than an optimised version.\r\n","author":{"url":"https://github.com/AA-Turner","@type":"Person","name":"AA-Turner"},"datePublished":"2022-06-07T10:40:36.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":7},"url":"https://github.com/459/core-workflow/issues/459"}