summaryrefslogtreecommitdiffstats
path: root/.github
diff options
context:
space:
mode:
authorAdam Turner <9087854+AA-Turner@users.noreply.github.com>2023-04-27 18:27:38 (GMT)
committerGitHub <noreply@github.com>2023-04-27 18:27:38 (GMT)
commit44b5c21f4124f9fa1312fada313c80c6abfa6d49 (patch)
tree4f92a6c559f4ca94f4472193197ff4a28a16f345 /.github
parent0b7fd8ffc5df187edf8b5d926cee359924462df5 (diff)
downloadcpython-44b5c21f4124f9fa1312fada313c80c6abfa6d49.zip
cpython-44b5c21f4124f9fa1312fada313c80c6abfa6d49.tar.gz
cpython-44b5c21f4124f9fa1312fada313c80c6abfa6d49.tar.bz2
GH-103903: Test the minimum Sphinx version in CI (#103904)
Diffstat (limited to '.github')
-rw-r--r--.github/workflows/doc.yml20
1 files changed, 20 insertions, 0 deletions
diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml
index 28300d8..3f7550c 100644
--- a/.github/workflows/doc.yml
+++ b/.github/workflows/doc.yml
@@ -79,6 +79,26 @@ jobs:
# Build docs with the '-n' (nit-picky) option, convert warnings to errors (-W)
make -C Doc/ PYTHON=../python SPHINXOPTS="-q -n -W --keep-going" html 2>&1
+ # This build doesn't use problem matchers or check annotations
+ # It also does not run 'make check', as sphinx-lint is not installed into the
+ # environment.
+ build_doc_oldest_supported_sphinx:
+ name: 'Docs (Oldest Sphinx)'
+ runs-on: ubuntu-latest
+ timeout-minutes: 60
+ steps:
+ - uses: actions/checkout@v3
+ - name: 'Set up Python'
+ uses: actions/setup-python@v4
+ with:
+ python-version: '3.11' # known to work with Sphinx 3.2
+ cache: 'pip'
+ cache-dependency-path: 'Doc/requirements-oldest-sphinx.txt'
+ - name: 'Install build dependencies'
+ run: make -C Doc/ venv REQUIREMENTS="requirements-oldest-sphinx.txt"
+ - name: 'Build HTML documentation'
+ run: make -C Doc/ SPHINXOPTS="-q" SPHINXERRORHANDLING="-W --keep-going" html
+
# Run "doctest" on HEAD as new syntax doesn't exist in the latest stable release
doctest:
name: 'Doctest'