I've created an ocata blueprint for continuing the api-ref cleanup work: https://blueprints.launchpad.net/nova/+spec/api-ref-in-rst-ocata Please move outstanding (or new) changes to the new blueprint. https://review.openstack.org/#/q/topic:bp/api-ref-in-rst+status:open -- Thanks, Matt Riedemann