[Openstack-docs] Heat templates guide

Tom Fifield tom at openstack.org
Wed Jul 16 19:17:34 UTC 2014


On 16/07/14 12:13, Gauvain Pocentek wrote:
> 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.

How would this interface with the translation machinery?

> - 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/
> 
> 
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs




More information about the Openstack-docs mailing list