[openstack-dev] [all] versioning the api-ref?

Sean Dague sean at dague.net
Thu Aug 18 17:19:49 UTC 2016


On 08/18/2016 11:57 AM, Nikhil Komawar wrote:
> I guess the intent was to indicate the need for indicating the micro or
> in case of Glance minor version bump when required.
> 
> The API isn't drastically different, there are new and old elements as
> shown in the Nova api ref linked.

Right, so the point is that it should all be describable in a single
document. It's like the fact that when you go to python API docs you get
things like - https://docs.python.org/2/library/wsgiref.html

"New in version 2.5."

Perhaps if there is a concrete example of the expected differences
between what would be in the mitaka tree vs. newton tree was can figure
out an appropriate way to express that in api-ref.

	-Sean

-- 
Sean Dague
http://dague.net



More information about the OpenStack-dev mailing list