<div dir="ltr">Hi. I do not have an opinion about including the tables and figures.<div>Just checking on what should be included or not.</div><div>The links provide another navigation point into the documentation.</div><div>For information that is used frequently, say a common installation routine or </div><div>API commands, a link may be useful.</div><div>I can try and do the initial conversion of app_support.xml to user-guides/source/common/app_support.rst? Where would this file be included, under indices and tables in index.rst and index-admin.rst?</div><div>-Karen</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Apr 6, 2015 at 10:54 AM, Anne Gentle <span dir="ltr"><<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span class="">On Mon, Apr 6, 2015 at 9:48 AM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.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"><span>On 04/06/2015 03:38 PM, Karen Bradshaw 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. I am reviewing the new content generated for the admin user guide.<br>
</blockquote>
<br></span>
thanks!<span><br>
<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">
Is there a plan to add an appendix for community support information?<br>
</blockquote>
<br></span>
IMHO it would be great to have it. Do you want to convert it?</blockquote><div><br></div></span><div>Please do add it. If you can't convert it, just let me know and I'll do it.</div><span class=""><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"><span><br>
<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">
How about adding labels for the tables and figures?<br>
</blockquote>
<br></span>
If we do this, let's write it down on our markup conventions page as well. I'm not feeling strongly either right now,<br></blockquote><div><br></div><div><br></div></span><div>Currently our convention for RST markup is to only use the image directive. We'd have to start using the figure directive in order to get a caption for each figure. </div><div><br></div><div><a href="https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Image" target="_blank">https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Image</a> is where the convention is documented. <br></div><div><br></div><div>For tables, I'm not aware of a way to ensure a caption is used, other than to put it in our conventions as a paragraph before the table. </div><div><br></div><div>With the migration goal of simplifying and welcoming more contributors, it seems a little heavy-handed to require captions for tables and figures. So I want to hear why we would require them other than "we've done it that way before." Any thoughts? I can't justify the overhead when we aren't doing collections of them in the new world. Any other thoughts? </div><div><br></div><div>Thanks,</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">
<br>
Andreas<span><font color="#888888"><span class=""><br>
-- <br>
Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,<br>
Graham Norton, HRB 21284 (AG Nürnberg)<br>
GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br>
<br>
<br></span>
______________________________<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><span class="HOEnZb"><font color="#888888"><br>
</font></span></font></span></blockquote></div><span class="HOEnZb"><font color="#888888"><br><br clear="all"><div><br></div>-- <br><div>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</font></span></div></div>
</blockquote></div><br></div>