[OpenStack-docs] [api] [docs] [cinder] [swift] [glance] [keystone] [ironic] [trove] [neutron] [heat] [senlin] [manila] [sahara] RST + YAML files ready for pick up from WADL migration

Andreas Jaeger aj at suse.com
Tue May 3 13:48:55 UTC 2016


Anne, this is great! Congrats!

Will you -2 all open changes and point them to your email?

Andreas

On 05/03/2016 03:29 PM, Anne Gentle wrote:
> Hi all,
> This patch contains all the RST + YAML for projects to bring over to
> their repos to begin building API reference information from within your
> repo. Get a copy of this patch, and pick up the files for your service
> in api-site/api-ref/source/<service>:
>
> https://review.openstack.org/#/c/311596/
>
> There is required cleanup, and you'll need an index.rst, conf.py, and
> build jobs. All of these can be patterned after the nova repository
> api-ref directory. Read more at
> http://docs.openstack.org/contributor-guide/api-guides.html
>
> It's overall in good shape thanks to Karen Bradshaw, Auggy Ragwitz,
> Andreas Jaeger, and Sean Dague. Appreciate the help over the finish line
> during Summit week, y'all.
>
> The api-site/api-ref files are now frozen and we will not accept
> patches. The output at developer.openstack.org/api-ref.html
> <http://developer.openstack.org/api-ref.html> remains frozen until we
> can provide redirects to the newly-sourced-and-built files. Please, make
> this work a priority in this release. Ideally we can get everyone ready
> by Milestone 1 (May 31).
>
> If you would like to use a Swagger/OpenAPI file, pick that file up from
> developer.openstack.org/draft/swagger/
> <http://developer.openstack.org/draft/swagger/> and create build jobs
> from your repo to publish it on developer.openstack.org
> <http://developer.openstack.org>.



-- 
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
   SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
    GF: Felix Imendörffer, Jane Smithard, Graham Norton,
        HRB 21284 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126




More information about the OpenStack-docs mailing list