Open Stack

Hi all,

We discussed how to add a HOT template guide ([bp]) off list and we'd 
like to have some feedback before getting really started.

So what we plan to do is:

- Write the guide in RST and generate a docbook chapter (the tool to do 
so is almost ready) that will be included in the user guide. We really 
think this is the way to go, because we want to make things easier for 
developers to contribute. So unless there are strong feelings against 
this, we'll probably get started soon.

- We (I?)'d like to include the HOT reference ([ref]) in the manuals, 
but we're not sure where we should include it. Including it in the user 
guide would probably clutter this guide, the CLI and config references 
don't look like good candidates either, and another guide just for this 
is probably overkill. A last solution is to keep the (unversioned) 
reference in the developer/ namespace.
What do you guys think about this?

Thanks,
Gauvain

[bp]: 
https://blueprints.launchpad.net/openstack-manuals/+spec/heat-templates)
[ref]: http://docs.openstack.org/developer/heat/template_guide/