missing parameter explaination in "Servers" section of v2.1 compute api

[Chengshuo]

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.

[Atsushi SAKAI (sakaia)]

Thank you for your reporting. Currently the nova issue for api-site is freezing state.

Ref.
http://lists.openstack.org/pipermail/openstack-docs/2016-April/008453.html

[Matt Riedemann (mriedem)]

This should be cleaned up as part of this blueprint in newton:

https://blueprints.launchpad.net/nova/+spec/api-ref-in-rst

[Markus Zoeller (markus_z) (mzoeller)]

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