Open Stack

Le 2014-07-16 21:17, Tom Fifield a écrit :
> 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'll add the generated docbook as a file in the manuals repository, so 
the tools will work exactly the same on this chapter. The inclusion will 
most likely be manual for starters, and we'll see if we need to automate 
things later.


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