<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Jul 16, 2014 at 2:13 PM, Gauvain Pocentek <span dir="ltr"><<a href="mailto:gauvain.pocentek@objectif-libre.com" target="_blank">gauvain.pocentek@objectif-libre.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">Hi all,<br>
<br>
We discussed how to add a HOT template guide ([bp]) off list and we'd like to have some feedback before getting really started.<br>
<br>
So what we plan to do is:<br>
<br>
- 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.<br>


<br></blockquote><div><br></div><div>I'm okay with this, but will say in my experience rst to docbook is fiddly and you only want to do it once, it's not automatable. (I know you're not talking about repeated imports, just one time.) </div>

<div><br></div><div>One thing I noted is that there is already an RST guide, but I've gotten feedback that it's too simple of an example and we'll want to add a more real-world example. So I'd say start with the RST files that exists at <a href="http://git.openstack.org/cgit/openstack/heat/tree/doc/source/template_guide">http://git.openstack.org/cgit/openstack/heat/tree/doc/source/template_guide</a> and go from there.</div>

<div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
- 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.<br>


What do you guys think about this?<br>
<br></blockquote><div><br></div><div>I think that the HOT Reference can be a separate guide like the CLI Ref and Config Ref. It's not a lot of overhead since it's automatically generated.</div><div><br></div><div>

Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
Thanks,<br>
Gauvain<br>
<br>
[bp]: <a href="https://blueprints.launchpad.net/openstack-manuals/+spec/heat-templates" target="_blank">https://blueprints.launchpad.<u></u>net/openstack-manuals/+spec/<u></u>heat-templates</a>)<br>
[ref]: <a href="http://docs.openstack.org/developer/heat/template_guide/" target="_blank">http://docs.openstack.org/<u></u>developer/heat/template_guide/</a><br>
<br>
<br>
______________________________<u></u>_________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.<u></u>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/<u></u>cgi-bin/mailman/listinfo/<u></u>openstack-docs</a><br>
</blockquote></div><br></div></div>