<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">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 class="">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 class=""><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><div>Please do add it. If you can't convert it, just let me know and I'll do it.</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"><span class=""><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><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">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 class=""><font color="#888888"><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>
______________________________<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>
</font></span></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature">Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</div></div>