[OpenStack-docs] Style column in OpenStack API docs
Henry Fourie
louis.fourie at huawei.com
Wed May 18 20:25:24 UTC 2016
Anne,
So for new APIs the procedure for API documentation is as described here?
http://docs.openstack.org/contributor-guide/api-guides.html
When will the neutron API be converted to use parameters.yaml?
I am adding API documentation for networking-sfc. Once I have added the necessary files
to api-ref/source, and verified them with tox -e api-ref what must I do to get the
resulting documentation published to say http://docs.openstack.org/mitaka/networking-sfc
- Louis
From: Anne Gentle [mailto:annegentle at justwriteclick.com]
Sent: Wednesday, May 18, 2016 1:14 PM
To: Henry Fourie
Cc: openstack-docs at lists.openstack.org
Subject: Re: [OpenStack-docs] Style column in OpenStack API docs
Thanks for the link.
That's from WADL, the style attribute. See this line in the source:
https://github.com/openstack/api-site/blob/master/api-ref/src/wadls/networking-api/src/wadl/networks.wadl#L93
For the new parameters.yaml file, there aren't style attributes. Rather, there's these attributes per param, in, required, and type:
param-name:
in: body
required: true
type: boolean
See
https://review.openstack.org/#/c/314819/1/api-ref/source/v2/parameters.yaml for the new format.
Hope this info helps - let me know what you're looking to do with the info.
Anne
On Wed, May 18, 2016 at 3:05 PM, Henry Fourie <louis.fourie at huawei.com<mailto:louis.fourie at huawei.com>> wrote:
Anne,
See for example http://developer.openstack.org/api-ref-networking-v2.html
Click on Detail for Networks to see Request or Response parameter tables.
- Louis
From: Anne Gentle [mailto:annegentle at justwriteclick.com<mailto:annegentle at justwriteclick.com>]
Sent: Wednesday, May 18, 2016 1:01 PM
To: Henry Fourie
Cc: openstack-docs at lists.openstack.org<mailto:openstack-docs at lists.openstack.org>
Subject: Re: [OpenStack-docs] Style column in OpenStack API docs
Hi Louis,
Can you send a link or screenshot of what you mean by the Style column? I'm not sure what you're looking at and the API docs are transitioning to RST + YAML, built with Sphinx. So, let me know more about where you see this column and what you'd like to do once you learn more.
Thanks,
Anne
On Wed, May 18, 2016 at 2:35 PM, Henry Fourie <louis.fourie at huawei.com<mailto:louis.fourie at huawei.com>> wrote:
What is the usage of the Style column in OpenStack API docs?
How is this column created?
- Louis
_______________________________________________
OpenStack-docs mailing list
OpenStack-docs at lists.openstack.org<mailto:OpenStack-docs at lists.openstack.org>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
--
Anne Gentle
www.justwriteclick.com<http://www.justwriteclick.com>
--
Anne Gentle
www.justwriteclick.com<http://www.justwriteclick.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20160518/b3136f90/attachment.html>
More information about the OpenStack-docs
mailing list