Merge "tox: Stop build *all* docs in 'docs'" into stable/rocky

tox.ini

@@ -168,7 +168,7 @@ commands =
 
 [testenv:docs]
 description =
-  Build all documentation including API guides and refs.
+  Build main documentation.
 deps = -r{toxinidir}/doc/requirements.txt
 commands =
   rm -rf doc/build
@@ -179,9 +179,6 @@ commands =
   sphinx-build -W -b html doc/source doc/build/html
   # Test the redirects. This must run after the main docs build
   whereto doc/build/html/.htaccess doc/test/redirect-tests.txt
-  {[testenv:api-guide]commands}
-  {[testenv:api-ref]commands}
-  {[testenv:placement-api-ref]commands}
 
 [testenv:api-guide]
 description =
@@ -219,6 +216,18 @@ commands =
   rm -rf releasenotes/build
   sphinx-build -W -b html -d releasenotes/build/doctrees releasenotes/source releasenotes/build/html
 
+[testenv:all-docs]
+description =
+  Build all documentation including API guides and refs.
+envdir = {toxworkdir}/docs
+deps = -r{toxinidir}/doc/requirements.txt
+commands =
+  {[testenv:docs]commands}
+  {[testenv:api-guide]commands}
+  {[testenv:api-ref]commands}
+  {[testenv:placement-api-ref]commands}
+  {[testenv:releasenotes]commands}
+
 [testenv:bandit]
 # NOTE(browne): This is required for the integration test job of the bandit
 # project. Please do not remove.