[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