<div dir="ltr"><div>Hi,</div><div><br></div><div><br></div><div>It seems the openstack-tox-docs job is broken in some projects because of the following</div><div>change made in Sphinx >= 5.0.0 .</div><div> <a href="https://github.com/sphinx-doc/sphinx/commit/a3d09835522e6487cf93dcc871179db8d69e4180">https://github.com/sphinx-doc/sphinx/commit/a3d09835522e6487cf93dcc871179db8d69e4180</a></div><div><br></div><div>We currently have Sphinx 4.5.0 in upper-constraints.txt but some projects (eg. Heat, Nova,</div><div>Neutron) are using only their own docs-constraints.txt and pull the latest version which is 5.0.1 .</div><div><br></div><div>IMO we need to fix the problem by the following two steps, but I'd appreciate</div><div>if anybody can share a better idea.</div><div><br></div><div> 1. Update tox.ini to honor upper-constraints.txt. This is needed in master and</div><div>     stable/branches as well.</div><div><br></div><div> 2. Update docs/source/conf.py to hard-code the language parameter to 'en'.</div><div>     This is required in master so that we can bump the upper version later.<br></div><div><br></div><div>Thank you,</div><div>Takashi Kajinami</div></div>