<div dir="ltr"><div>Thanks a lot for the reply. I guess we will leave this particular doc change as is, but I can revise as necessary to use the autodoc tools. We do plan to continuously update vmware related docs as things change, but obviously manual changes can lead to staleness.<br>
<br></div>Dan<br></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Nov 27, 2013 at 7:18 PM, Steve Gordon <span dir="ltr"><<a href="mailto:sgordon@redhat.com" target="_blank">sgordon@redhat.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">----- Original Message -----<br>
> From: "Dan Florea" <<a href="mailto:dan.florea@gmail.com">dan.florea@gmail.com</a>><br>
> To: "Stephen Gordon" <<a href="mailto:sgordon@redhat.com">sgordon@redhat.com</a>><br>
> Sent: Tuesday, November 26, 2013 8:34:17 PM<br>
> Subject: help with one of your review comments<br>
><br>
> Hi Stephen,<br>
><br>
> Regarding your comment in this review:<br>
><br>
> <a href="https://review.openstack.org/#/c/57791/" target="_blank">https://review.openstack.org/#/c/57791/</a><br>
><br>
> Can you point me to an example or provide some help on how to reference<br>
> the autoconf table? My proposed doc includes a set of example<br>
> instructions for configuration. I don't know where else they should go<br>
> or where the autoconf table lives. But I'm more than happy to make the<br>
> change as needed.<br>
><br>
> Thanks,<br>
> Dan<br>
<br>
I've somewhat waned on my opinion here, but the autodoc tools live under the tools directory in the openstack-manuals repository and generate the tables in the config-reference guide based on the configurations defined in the code of the relevant projects themselves.<br>

<br>
So the upside is that by generating in this fashion they are less prone to get "stale" the downside is the resultant table(s) do not necessarily clearly illustrate a working config - though I don't necessarily think dumping one in the guide itself is always that helpful either - adding the replaceables at least makes it clear what needs to be changed though :).<br>

<br>
Thanks,<br>
<br>
Steve<br>
</blockquote></div><br></div>