From: Victor Stinner <vstinner@python.org>
Date: Thu, 9 Dec 2021 23:02:20 +0000 (+0100)
Subject: bpo-46016: GHA Doc job now also runs "make check" (GH-30009)
X-Git-Tag: v3.11.0a4~241
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=da3cf4304f6dd530533bbd2c0913b674cd803744;p=thirdparty%2FPython%2Fcpython.git

bpo-46016: GHA Doc job now also runs "make check" (GH-30009)

The GitHub Action documentation job now also runs "make check" to
check the documentation.
---

diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml
index 755a4d5e173e..ed44409d118a 100644
--- a/.github/workflows/doc.yml
+++ b/.github/workflows/doc.yml
@@ -38,8 +38,15 @@ jobs:
       run: make -j4
     - name: 'Install build dependencies'
       run: make -C Doc/ PYTHON=../python venv
-    - name: 'Build documentation'
-      run: xvfb-run make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going -j4" doctest html
+    # Run "check doctest html" as 3 steps to get a more readable output
+    # in the web UI
+    - name: 'Check documentation'
+      run: make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going -j4" check
+    # Use "xvfb-run" since some doctest tests open GUI windows
+    - name: 'Run documentation doctest'
+      run: xvfb-run make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going -j4" doctest
+    - name: 'Build HTML documentation'
+      run: make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going -j4" html
     - name: 'Upload'
       uses: actions/upload-artifact@v2.2.4
       with: