[OpenStack-docs] API versioning and release versioning

Alexandra Settle 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 [1], 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!


1. http://lists.openstack.org/pipermail/openstack-dev/2017-April/114986.html

On Mon, Apr 3, 2017 at 10:36 AM, Anne Gentle <annegentle at justwriteclick.com<mailto:annegentle at justwriteclick.com>> wrote:
Hi all,
I wanted to bring this thread to your attention, as it is relevant to the API documentation.

From http://lists.openstack.org/pipermail/openstack-dev/2017-March/114690.html:
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
it differently.

If anyone has ideas for surfacing this information, please join in the feedback request on the openstack-dev mailing list.

Thanks -


Read my blog: justwrite.click<https://justwriteclick.com>
Subscribe to Docs|Code: docslikecode.com<http://docslikecode.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20170420/a78e6b7b/attachment-0001.html>

More information about the OpenStack-docs mailing list