<div dir="ltr"><div>Sorry it seems I was looking at something wrong and it seems the projects</div><div>I mentioned as examples(Heat, Nova and Neutron) are already using upper</div><div>constraints for doc build. However I'd recommend reach project reviews</div><div>their current tox.ini.<br></div><div><br></div><div>Updating conf.py would be still required so it's better to work on it earlier<br></div><div>before the upper constraint is updated.<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Jun 6, 2022 at 1:15 PM Takashi Kajinami <<a href="mailto:tkajinam@redhat.com">tkajinam@redhat.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><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" target="_blank">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>
</blockquote></div>