@@ -56,11 +56,13 @@ jobs:
5656
5757 # Add pull request annotations for Sphinx nitpicks (missing references)
5858 - name : ' Get list of changed files'
59+ if : github.event_name == 'pull_request'
5960 id : changed_files
60616162 with :
6263 filter : " Doc/**"
6364 - name : ' Build changed files in nit-picky mode'
65+ if : github.event_name == 'pull_request'
6466 continue-on-error : true
6567 run : |
6668 # Mark files the pull request modified
7779 # Build docs with the '-n' (nit-picky) option, convert warnings to errors (-W)
7880 make -C Doc/ PYTHON=../python SPHINXOPTS="-q -n -W --keep-going" html 2>&1
7981
82+ # This build doesn't use problem matchers or check annotations
83+ # It also does not run 'make check', as sphinx-lint is not installed into the
84+ # environment.
85+ build_doc_oldest_supported_sphinx :
86+ name : ' Docs (Oldest Sphinx)'
87+ runs-on : ubuntu-latest
88+ timeout-minutes : 60
89+ steps :
90+ - uses : actions/checkout@v3
91+ - name : ' Set up Python'
92+ uses : actions/setup-python@v4
93+ with :
94+ python-version : ' 3.11' # known to work with Sphinx 3.2
95+ cache : ' pip'
96+ cache-dependency-path : ' Doc/requirements-oldest-sphinx.txt'
97+ - name : ' Install build dependencies'
98+ run : make -C Doc/ venv REQUIREMENTS="requirements-oldest-sphinx.txt"
99+ - name : ' Build HTML documentation'
100+ run : make -C Doc/ SPHINXOPTS="-q" SPHINXERRORHANDLING="-W --keep-going" html
101+
80102 # Run "doctest" on HEAD as new syntax doesn't exist in the latest stable release
81103 doctest :
82104 name : ' Doctest'
0 commit comments