Open Stack

On Wed, May 18, 2016 at 3:25 PM, Henry Fourie <louis.fourie at huawei.com>
wrote:

> Anne,
>
>   So for new APIs the procedure for API documentation is as described here?
>
> http://docs.openstack.org/contributor-guide/api-guides.html
>
>
>

Yes.


> When will the neutron API be converted to use parameters.yaml?
>
>
>

Yes, the review.openstack.org link at
https://review.openstack.org/#/c/314819 is to the patch where the
conversion is being reviewed now.


> 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
>
>
You have the idea. There's a need for a second patch like this one for
swift, https://review.openstack.org/#/c/313015/ that creates the
infrastructure jobs to publish to
developer.openstack.org/api-ref/<servicename>/
such as http://developer.openstack.org/api-ref/compute/. If you have a
networking-sfc repo, then you'll need two patches to get your API ref
publishing, one for the source code repo, one for the project-config repo.

Hope that helps -
Anne


>
>
> -        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>
> 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]
> *Sent:* Wednesday, May 18, 2016 1:01 PM
> *To:* Henry Fourie
> *Cc:* 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>
> 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
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>
>
>
>
> --
>
> Anne Gentle
>
> www.justwriteclick.com
>
>
>
>
>
> --
>
> Anne Gentle
>
> www.justwriteclick.com
>



-- 
Anne Gentle
www.justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20160518/6a5e3e3b/attachment-0001.html>