[OpenStack-docs] API versioning and release versioning

Anne Gentle annegentle at justwriteclick.com
Wed Apr 19 16:00:15 UTC 2017


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!

Anne

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>
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 -
> Anne
>
>


-- 

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


More information about the OpenStack-docs mailing list