[openstack-dev] [neutron] autodoc and tox-siblings

Andreas Jaeger aj at suse.com
Tue Jul 3 06:27:35 UTC 2018

On 2018-07-03 06:12, Takashi Yamamoto wrote:
> hi,
> - networking-midonet uses autodoc in their doc.
> build-openstack-sphinx-docs runs it.

> - build-openstack-sphinx-docs doesn't use tox-siblings. thus the job
> uses released versions of dependencies. eg. neutron, neutron-XXXaas,
> os-vif, etc
> - released versions of dependencies and networking-midonet master are
> not necessarily compatible
> - a consequence: https://bugs.launchpad.net/networking-midonet/+bug/1779801
>   (in this case, neutron-lib and neutron are not compatible)
> possible solutions i can think of:
> - stop using autodoc (i suspect i have to do this for now)
> - make intermediate releases of neutron and friends
> - finish neutron-lib work and stop importing neutron etc (ideal but we
> have not reached this stage yet)
> - make doc job use tox-siblings (as it used to do in tox_install era)
> any suggestions?

Did you see
- best discuss with Stephen whether that's a better solution,

 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,
       HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126

More information about the OpenStack-dev mailing list