<div dir="ltr">Hi all, <div>It's not about the look, but that both <literal> and <emphasis> don't really describe the content. Generally speaking, emphasis is frowned upon by semantic markup because it's not meaningful. In the case of the patch Christian's working on, the content is "Limitations" and there are enough of them that are described in brief and in depth that probably Christian should just convert the list to a table with headings: Limitation and Description. That'll help readers scan the output and the markup isn't so vague as emphasis. Christian's been doing good work on converting lists to tables, so I think that's the solution here as well.  </div>

<div><br></div><div>Christian, does that sound good to you? Tom and Stephen and other knowledgeable docbook markup folks, does that markup sound right to you?</div><div><br></div><div>Thanks for bringing it to the mailing list, it's a good conversation to have while we have lots of cleanup.</div>

<div>Anne</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Sat, Aug 3, 2013 at 4:18 PM, Tom Fifield <span dir="ltr"><<a href="mailto:tom@openstack.org" target="_blank">tom@openstack.org</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi all,<br>
<br>
Just bringing the discussion from <a href="https://review.openstack.org/#/c/39712" target="_blank">https://review.openstack.org/#/c/39712</a><br>
to the mailing list.<br>
<br>
In the patch, emphasis tags are changed to literal tags for better<br>
readability.<br>
<br>
Since these tags have semantic backing, and we could potentially change<br>
the look for them later, I thought it was worth discussing on the<br>
mailing list.<br>
<br>
So - how do you feel about how emphasis tags look right now in HTML and<br>
PDF? How should we make it better?<br>
<br>
<br>
Regards,<br>
<br>
<br>
Tom<br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div>