Open Stack

What is the goal for Sphinx 2.4?

From: Dmitry Tantsur <dtantsur at redhat.com>
Sent: Sunday, March 29, 2020 8:34 AM
To: openstack-discuss
Subject: Re: OpenStack should be buildable with sphinx 2.4: FTBFS in many packages


[EXTERNAL EMAIL]


On Sat, Mar 28, 2020 at 10:08 PM Akihiro Motoki <amotoki at gmail.com<mailto:amotoki at gmail.com>> wrote:
Hi,

Find my comments on several repositories.

On Sat, Mar 28, 2020 at 6:34 PM Thomas Goirand <zigo at debian.org<mailto:zigo at debian.org>> wrote:
>
> Hi,
>
> Sphinx 2.4 has been uploaded to Experimental. I just received bug
> reports against the OpenStack packages because some of them cannot be
> built with Sphinx 2.4. Here's the list:
>
> - ironic
> - os-api-ref

I can build the document with sphinx 2.4.4.

> - aodh
> - cloudkitty
> - kombu

This is not part of OpenStack and is not found in opendev.org<http://opendev.org>.

> - panko
> - ceilometerclient
> - ceilometermiddleware
> - doc8

doc8 was retired Jul 2019.

For those like me who just nearly had a heart attack: it wasn't fully retired, it was moved (?) to https://github.com/PyCQA/doc8


> - dracclient
> - glareclient
> - murano-pkg-check
> - os-xenapi
> - scciclient
> - sahara
> - sphinxcontrib-programoutput

This is not part of OpenStack and is not found in opendev.org<http://opendev.org>.

> - tempest-horizon

sphinx document is not actually used and the content was not changed
under the initial cookiecutter commit.
I proposed a patch to drop sphinx related stuffs. Hope it works for you.

>
> It'd be nice if those affected could be fixed for Ussuri. IMO, it's just
> the doc, so fixing it wouldn't hurt code quality. In other words: help
> would be more than welcome writing patch or reviewing them, and testing
> Sphinx 2.4 compatibility.
>
> Cheers,
>
> Thomas Goirand (zigo)
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-discuss/attachments/20200329/e6951af1/attachment-0001.html>