[openstack-dev] [nova] API v2.1 reference documentation

melanie witt melwittt at gmail.com
Tue Sep 8 23:00:43 UTC 2015


Hi All,

With usage of v2.1 picking up (devstack) I find myself going to the API ref documentation [1] often and find it lacking compared with the similar v2 doc [2]. I refer to this doc whenever I see a novaclient bug where something broke with v2.1 and I'm trying to find out what the valid request parameters are, etc.

The main thing I notice is in the v2.1 docs, there isn't any request parameter list with descriptions like there is in v2. And I notice "create server" documentation doesn't seem to exist -- there is "Create multiple servers" but it doesn't provide much nsight about what the many request parameters are.

I assume the docs are generated from the code somehow, so I'm wondering how we can get this doc improved? Any pointers would be appreciated.

Thanks,
-melanie (irc: melwitt)


[1] http://developer.openstack.org/api-ref-compute-v2.1.html
[2] http://developer.openstack.org/api-ref-compute-v2.html

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 496 bytes
Desc: Message signed with OpenPGP using GPGMail
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150908/ba9f79ff/attachment.pgp>


More information about the OpenStack-dev mailing list