Outputs for parameters are missing for WADL embedded in DocBook for a "API Spec"

[Anne Gentle]

Compare the amount of info given in this output for a POST to create a LB pool:
http://docs.openstack.org/api/openstack-network/2.0/content/POST_createPool__v2.0_lb_pools_lbaas_ext_ops_pool.html

with this output:
http://developer.openstack.org/api-ref-networking-v2.html#lbaas

both sourced from WADL, but the first output gives less info.

[Anne Gentle (annegentle)]

I find that the Developer Reference output is less helpful for app developers. The document may be slightly useful for contributor developers but they are instead just collaborating in easier ways, such as using a Google Doc.

[min wang (swiftwangster)]

Great, thanks Anne!

[Liusheng (liusheng)]

When I check this bug, I have found that, the req json and the response json are wrong

[min wang (swiftwangster)]

hey Liusheng, can you give a particular example for the wrong req and response json so we can double check.

[Liusheng (liusheng)]

Hi, min wang, I have uploaded a patch to fix this bug:https://review.openstack.org/#/c/107603/

the patch review page clearly show the correct req and response json and the previous wrong json. (I change the json with latest neutron and neutronclient code)

thanks :)

[min wang (swiftwangster)]

@Liusheng , i checked your change, and i am wondering what is your base of the code change, which document did you use as reference. I used this one : https://docs.google.com/document/d/160hjgBYN8IzZPe6aPyNl7Y2C4ZeQIQ4GNTOCTHcvbkA/edit#heading=h.4fydv48sbcpo

[Anne Gentle (annegentle)]

The first output will no longer be updated so I'm marking this as Won't Fix. Please open a new bug if you find that the LBaaS doc at http://developer.openstack.org/api-ref-networking-v2-ext.html#lbaas-v1.0 or http://developer.openstack.org/api-ref-networking-v2-ext.html#lbaas-v2.0 are incorrect.