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

Takashi Yamamoto yamamoto at midokura.com
Tue Jul 3 04:12:53 UTC 2018


- 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?

More information about the OpenStack-dev mailing list