Use upper-constraint in doc generation

Currently doc jobs are broken because the latest sphinx 7.2.0 is not
compatible with the latest release of openstackdocstheme.

This updates the docs/releasenotes target to use the global upper
constraints to avoid that issue.

Conflicts:
	tox.ini

Change-Id: I7eef81e2cfc2156dd8aa076e09de4904dda6eb9a
(cherry picked from commit 8c89839e37)

tox.ini

@@ -7,12 +7,12 @@ ignore_basepython_conflict = True
 usedevelop = True
 basepython = python3
 setenv =
-   VIRTUAL_ENV={envdir}
-   OS_TEST_PATH=./castellan/tests/unit
+  VIRTUAL_ENV={envdir}
+  OS_TEST_PATH=./castellan/tests/unit
 deps =
-       -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/2024.1}
-       -r{toxinidir}/requirements.txt
-       -r{toxinidir}/test-requirements.txt
+  -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/2024.1}
+  -r{toxinidir}/requirements.txt
+  -r{toxinidir}/test-requirements.txt
 commands = stestr run --slowest --concurrency=1 {posargs}
 
 [testenv:pep8]
@@ -53,10 +53,12 @@ commands =
 # This environment is called from CI scripts to test and publish
 # the main docs to https://docs.openstack.org/castellan
 description = Build main documentation
-deps = -r{toxinidir}/doc/requirements.txt
+deps =
+  -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/2024.1}
+  -r{toxinidir}/doc/requirements.txt
 commands=
-    rm -rf doc/build doc/build/doctrees
-    sphinx-build -W -b html -d doc/build/doctrees doc/source doc/build/html
+  rm -rf doc/build doc/build/doctrees
+  sphinx-build -W -b html -d doc/build/doctrees doc/source doc/build/html
 allowlist_externals = rm
 
 [testenv:pdf-docs]