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.
Simplify caching
Follow on from #783 (review).
https://github.com/actions/setup-python now has pip caching built in so let's remove the whole
actions/cachestep here. It usesrequirements.txtas the key by default.Docs: https://github.com/actions/setup-python#caching-packages-dependencies
Enable build button
Also, add
workflow_dispatch, which adds a button to the GitHub Actions UI to let you trigger builds. This is something Travis CI has built in, and is fairly new to GHA and needs enabling.Docs: https://github.blog/changelog/2020-07-06-github-actions-manual-triggers-with-workflow_dispatch/
Add colour
Finally, GitHub Actions isn't a tty so tools such as sphinx-build that autodetect don't show the output in colour. So let's add
--colorto turn it on, especially useful for the link check. And let's show the docs build output too, useful for debugging failures (and now in colour!).