Update docs build requirements to most recent versions of dependencies (#76283)

* align requirements files to more recent versions

* bump up to latest antsibull

* update sphinx in rstcheck requirements

* update to dependency versions that sphinx 4.2 pulls in

* use same no-cap spelling

docs/docsite/known_good_reqs.txt

@@ -1,18 +1,19 @@
 # pip packages required to build docsite
-# tested June 9 2021
+# tested Nov 11 2021
+# NOTE - this file must align with CI test for docs-build at
+#    test/sanity/code-smell/docs-build.requirements.txt
+#    test/sanity/code-smell/rstcheck.requirements.txt
 
-antsibull
+antsibull == 0.39.2
-# version floats free, since we control features and releases
+# sphinx 4.2.0 requires docutils < 0.18
-docutils==0.16
+docutils == 0.17.1
-# check unordered lists when testing more recent docutils versions
+jinja2 == 3.0.3
-# see https://github.com/readthedocs/sphinx_rtd_theme/issues/1115
+pygments == 2.10.0
-jinja2==3.0.1
+pyyaml == 6.0
-Pygments==2.9.0
-PyYAML==5.4.1
 resolvelib == 0.5.4
 rstcheck == 3.3.1
-sphinx==4.0.2
+sphinx == 4.2.0
-sphinx-notfound-page==0.7.1 # must be >= 0.6
+sphinx-notfound-page == 0.8 # must be >= 0.6
 sphinx-intl == 2.0.1
-sphinx-ansible-theme===0.7.0
+sphinx-ansible-theme === 0.8.0
 straight.plugin == 1.5.0 # Needed for hacking/build-ansible.py which is the backend build script

docs/docsite/requirements.txt

@@ -3,12 +3,11 @@
 # if you want known good versions of these dependencies
 # use known_good_reqs.txt instead
 
-antsibull >= 0.38.2
+antsibull >= 0.39.2
-docutils == 0.16 # pin for now until the problem with unordered lists is fixed
+docutils
-# see https://github.com/readthedocs/sphinx_rtd_theme/issues/1115jinja2==3.0.1
 jinja2
-Pygments >= 2.4.0
+pygments >= 2.10.0
-PyYAML
+pyyaml
 rstcheck
 sphinx
 sphinx-notfound-page >= 0.6