[openstack-dev] [Openstack-docs] [Heat][Documentation] Heat template documentation

Steve Baker sbaker at redhat.com
Thu May 15 16:32:15 UTC 2014


On 15/05/14 11:54, Gauvain Pocentek wrote:
> (Resending to add openstack-dev)
>
> Gauvain Pocentek
>
> Objectif Libre - Infrastructure et Formations Linux
> http://www.objectif-libre.com
>
> Le 2014-05-15 17:34, Gauvain Pocentek a écrit :
>> Hello,
>>
>> This mail probably mainly concerns the doc team, but I guess that the
>> heat team wants to know what's going on.
>>
>> We've shortly discussed the state of heat documentation with Anne
>> Gentle and Andreas Jaeger yesterday, and I'd like to share what we
>> think would be nice to do.
>>
>> Currently we only have a small section in the user guide that
>> describes how to start a stack, but nothing documenting how to write
>> templates. The heat developer doc provides a good reference, but I
>> think it's not easy to use to get started.
>>
>> So the idea is to add an "OpenStack Orchestration" chapter in the
>> user guide that would document how to use a cloud with heat, and how
>> to write templates.
>>
>> I've drafted a spec to keep track of this at [0].
>>
>> Let me know if this sounds OK to you all.
>>
>> Gauvain Pocentek
>>
>> Objectif Libre - Infrastructure et Formations Linux
>> http://www.objectif-libre.com
>>
>> [0]:
>> https://blueprints.launchpad.net/openstack-manuals/+spec/heat-templates
>>
Thanks for raising this, I do hope I can help writing the content. In
addition to this, we will at some point need to port the resource
reference generation to this guide as well.



More information about the OpenStack-dev mailing list