[openstack-dev] [Heat] Defining what is a SupportStatus version

Angus Salkeld asalkeld at mirantis.com
Fri Sep 5 05:56:34 UTC 2014


On Fri, Sep 5, 2014 at 3:29 PM, Gauvain Pocentek <
gauvain.pocentek at objectif-libre.com> wrote:

> Hi,
>
> A bit of background: I'm working on the publication of the HOT resources
> reference on docs.openstack.org. This book is mostly autogenerated from
> the heat source code, using the sphinx XML output. To avoid publishing
> several references (one per released version, as is done for the OpenStack
> config-reference), I'd like to add information about the support status of
> each resource (when they appeared, when they've been deprecated, and so on).
>
> So the plan is to use the SupportStatus class and its `version` attribute
> (see https://review.openstack.org/#/c/116443/ ). And the question is,
> what information should the version attribute hold? Possibilities include
> the release code name (Icehouse, Juno), or the release version (2014.1,
> 2014.2). But this wouldn't be useful for users of clouds continuously
> deployed.
>
> From my documenter point of view, using the code name seems the right
> option, because it fits with the rest of the documentation.
>
> What do you think would be the best choice from the heat devs POV?
>
>
IMHO it should match the releases and tags (
https://github.com/openstack/heat/releases).

-Angus


Gauvain Pocentek
>
> Objectif Libre - Infrastructure et Formations Linux
> http://www.objectif-libre.com
>
> _______________________________________________
> OpenStack-dev mailing list
> OpenStack-dev at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20140905/57d9096a/attachment.html>


More information about the OpenStack-dev mailing list