chore: pin docs dependencies (#3402)

This should prevent having out docs pipeline getting broken
by changes made in sphinx or related dependencies.

Avoids latest Sphinx due to regression and include link to it.

.pre-commit-config.yaml

@@ -94,9 +94,9 @@ repos:
     rev: 6.4.0
     hooks:
       - id: pip-compile
-        entry: pip-compile -q --strip-extras --no-annotate --output-file=requirements.txt tools/opts.txt setup.cfg --extra test --extra yamllint
+        entry: pip-compile -q --strip-extras --no-annotate --output-file=requirements.txt tools/opts.txt setup.cfg --extra docs --extra test --extra yamllint
       - id: pip-compile
         name: pip-compile-upgrade
-        entry: pip-compile -q --strip-extras -q --upgrade --no-annotate --output-file=requirements.txt setup.cfg --extra test --extra yamllint
+        entry: pip-compile -q --strip-extras -q --upgrade --no-annotate --output-file=requirements.txt setup.cfg --extra docs --extra test --extra yamllint
         files: ^(setup\.cfg|requirements.txt|constraints\.txt)$
         stages: [manual]

requirements.txt

@@ -2,12 +2,15 @@
 # This file is autogenerated by pip-compile with python 3.6
 # To update, run:
 #
-#    pip-compile --extra=test --extra=yamllint --no-annotate --output-file=requirements.txt --strip-extras setup.cfg tools/opts.txt
+#    pip-compile --extra=docs --extra=test --extra=yamllint --no-annotate --output-file=requirements.txt --strip-extras setup.cfg tools/opts.txt
 #
+alabaster==0.7.12
 ansi2html==1.6.0
 ansible-compat==1.0.0
+ansible-pygments==0.1.0
 arrow==1.2.1
 attrs==21.4.0
+babel==2.9.1
 bcrypt==3.2.0
 binaryornot==0.4.4
 cached-property==1.5.2
@@ -25,26 +28,28 @@ coverage==6.2
 cryptography==36.0.1
 dataclasses==0.8 ; python_version < "3.7"
 distro==1.6.0
+docutils==0.17.1
 enrich==1.2.7
 execnet==1.9.0
 filelock==3.4.1
 idna==3.3
-importlib-metadata==4.2.0 ; python_version < "3.8"
+imagesize==1.3.0
+importlib-metadata==4.8.3 ; python_version < "3.8"
 iniconfig==1.1.1
 jinja2==3.0.3
 jinja2-time==0.2.0
 markupsafe==2.0.1
 more-itertools==8.12.0
 packaging==21.3
-paramiko==2.9.1
+paramiko==2.9.2
 pexpect==4.8.0
 pluggy==1.0.0
 poyo==0.5.0
 ptyprocess==0.7.0
 py==1.11.0
 pycparser==2.21
 pygments==2.11.2
-pynacl==1.4.0
+pynacl==1.5.0
 pyparsing==3.0.6
 pytest==6.2.5
 pytest-cov==3.0.0
@@ -57,11 +62,24 @@ pytest-testinfra==6.5.0
 pytest-xdist==2.5.0
 python-dateutil==2.8.2
 python-slugify==5.0.2
+pytz==2021.3
 pyyaml==6.0
 requests==2.27.1
 rich==11.0.0
 selinux==0.2.1
+simplejson==3.17.6
 six==1.16.0
+snowballstemmer==2.2.0
+sphinx==4.3.2
+sphinx-ansible-theme==0.9.0
+sphinx-notfound-page==0.8
+sphinx-rtd-theme==1.0.0
+sphinxcontrib-applehelp==1.0.2
+sphinxcontrib-devhelp==1.0.2
+sphinxcontrib-htmlhelp==2.0.0
+sphinxcontrib-jsmath==1.0.1
+sphinxcontrib-qthelp==1.0.3
+sphinxcontrib-serializinghtml==1.1.5
 subprocess-tee==0.3.5
 text-unidecode==1.3
 toml==0.10.2

setup.cfg

@@ -82,7 +82,7 @@ ansible =
 ansible-base =
     ansible-base >= 2.10
 docs =
-    Sphinx >= 4.0.2
+    Sphinx >= 4.3.2, < 4.4.0  # https://github.com/sphinx-doc/sphinx/issues/10112
     simplejson >= 3.17.2
     sphinx-ansible-theme >= 0.8.0, < 0.10.0
     sphinx-notfound-page >= 0.7.1