[OpenStack-docs] API versioning and release versioning
a.settle at outlook.com
Thu Apr 20 12:52:24 UTC 2017
Fantastic ☺ Thanks for your work Anne!
From: Anne Gentle <annegentle at justwriteclick.com>
Date: Wednesday, April 19, 2017 at 5:00 PM
To: "openstack-docs at lists.openstack.org" <openstack-docs at lists.openstack.org>
Subject: Re: [OpenStack-docs] API versioning and release versioning
Hi again docs list!
Related to the request I talked about previously, Monty Taylor and Jimmy MacArthur are requesting all teams with APIs to fill in the information in this review: https://review.openstack.org/#/c/454691
You can read the entire thread here , but realize that the process has changed to use the review in https://review.openstack.org/#/c/454691 instead.
Teams should get this filled in this week.
Alex, FYI, this is pretty much the API docs report this week for the weekly newsletter!
On Mon, Apr 3, 2017 at 10:36 AM, Anne Gentle <annegentle at justwriteclick.com<mailto:annegentle at justwriteclick.com>> wrote:
I wanted to bring this thread to your attention, as it is relevant to the API documentation.
What we really need is the following:
* A project history, including the date of project inception that's
included in the TC tags.
* An API history in an easily digestible format that all projects share.
So whether you're doing micro releases or not, just something that
allows us to show, based on a release timeline, which API versions per
project are applicable for each OpenStack release. This really needs to
be consistent from project to project b/c at the moment everyone handles
If anyone has ideas for surfacing this information, please join in the feedback request on the openstack-dev mailing list.
Read my blog: justwrite.click<https://justwriteclick.com>
Subscribe to Docs|Code: docslikecode.com<http://docslikecode.com>
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the OpenStack-docs