Hugo's review

Author: AA-Turner

.github/workflows/build-release.yml

@@ -169,7 +169,10 @@ jobs:
       - name: "Build docs"
         run: |
           cd Doc
-          SPHINXOPTS="-j10" make dist
+          SPHINXOPTS="-j10" make dist-epub
+          SPHINXOPTS="-j10" make dist-html
+          SPHINXOPTS="-j10" make dist-texinfo
+          SPHINXOPTS="-j10" make dist-text
 
       - name: "Upload the docs artifacts"
         uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2

release.py

@@ -707,8 +707,10 @@ def build_docs() -> str:
             "SPHINXOPTS": "-j10",
         }
         with pushd("Doc"):
+            run_cmd(("make", "dist-epub"), env=docs_env)
             run_cmd(("make", "dist-html"), env=docs_env)
-            run_cmd(("make", "dist-no-html"), env=docs_env)
+            run_cmd(("make", "dist-texinfo"), env=docs_env)
+            run_cmd(("make", "dist-text"), env=docs_env)
             return os.path.abspath("dist")
 
 

run_release.py

@@ -604,8 +604,6 @@ def wait_for_build_release(db: ReleaseShelf) -> None:
                 docs_path / f"python-{release_tag}-docs.epub",
                 docs_path / f"python-{release_tag}-docs-html.tar.bz2",
                 docs_path / f"python-{release_tag}-docs-html.zip",
-                docs_path / f"python-{release_tag}-docs-pdf-a4.tar.bz2",
-                docs_path / f"python-{release_tag}-docs-pdf-a4.zip",
                 docs_path / f"python-{release_tag}-docs-texinfo.tar.bz2",
                 docs_path / f"python-{release_tag}-docs-texinfo.zip",
                 docs_path / f"python-{release_tag}-docs-text.tar.bz2",

tests/README.rst

@@ -153,7 +153,7 @@ Documentation
 updated daily.
 
 It can also be downloaded in many formats for faster access.  The documentation
-is downloadable in HTML, PDF, and reStructuredText formats; the latter version
+is downloadable in HTML, EPUB, and reStructuredText formats; the latter version
 is primarily for documentation authors, translators, and people with special
 formatting requirements.