@@ -38,6 +38,8 @@ matrix:
         # Sphinx is pinned so that new versions that introduce new warnings won't suddenly cause build failures.
         # (Updating the version is fine as long as no warnings are raised by doing so.)
         # The theme used by the docs is stored seperately, so we need to install that as well.
+        # Note that the theme is intentionally not published to PyPI to avoid having the CPython
+        # maintainers deal with an intermediate release step.
         - python -m pip install sphinx~=1.6.1 git+https://github.com/python/python-docs-theme.git#egg=python-docs-theme
       script:
         - make check suspicious html SPHINXOPTS="-q -W -j4"
 
@@ -24,6 +24,9 @@ can install both using ``pip``::
 
     python -m pip install sphinx~=1.6.1 git+https://github.com/python/python-docs-theme.git#egg=python-docs-theme
 
+Note that the theme is intentionally not published to PyPI to avoid having the
+CPython maintainers deal with an intermediate release step.
+
 Using make
 ----------