I agree with Matt here, let's just close this bug report and use the blueprint "api-ref-in-rst" to drive this. The effort is described on the ML [1] and the wiki [2]. The file the bug reporter is referencing to has a comment at the top which describes the needed cleanup tasks [3].
Long story short, push the patch you planned to do but reference the bp instead of the bug. References: [1] [openstack-dev] [nova] api-ref content verification phase doc push http://lists.openstack.org/pipermail/openstack-dev/2016-April/092936.html [2] https://wiki.openstack.org/wiki/NovaAPIRef#Parameter_Verification [3] https://github.com/openstack/nova/blob/master/api-ref/source/servers.inc#L3 ** Changed in: nova Status: New => Opinion -- You received this bug notification because you are a member of Yahoo! Engineering Team, which is subscribed to OpenStack Compute (nova). https://bugs.launchpad.net/bugs/1572013 Title: missing parameter explaination in "Servers" section of v2.1 compute api Status in OpenStack Compute (nova): Opinion Bug description: URL: http://developer.openstack.org/api-ref-compute-v2.1.html I think the request parameters listed in "GET /v2.1/{tenant_id}/servers" of "Servers" section are not complete, when i want to get all servers of all tenants, there should be "?all_tenants=true" in the url, as i read in python-novaclient source code and it works actually after testing; but there is no specific description about "all_tenant" listed in "Request parameters" following in the api documentation. To manage notifications about this bug go to: https://bugs.launchpad.net/nova/+bug/1572013/+subscriptions -- Mailing list: https://launchpad.net/~yahoo-eng-team Post to : yahoo-eng-team@lists.launchpad.net Unsubscribe : https://launchpad.net/~yahoo-eng-team More help : https://help.launchpad.net/ListHelp