<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=Generator content="Microsoft Word 15 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
{font-family:"MS Mincho";
panose-1:2 2 6 9 4 2 5 8 3 4;}
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:"\@MS Mincho";
panose-1:2 2 6 9 4 2 5 8 3 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman",serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:#954F72;
text-decoration:underline;}
code
{mso-style-priority:99;
font-family:"Courier New";}
span.EmailStyle17
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></head><body lang=EN-US link="#0563C1" vlink="#954F72"><div class=WordSection1><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>I believed this is answered in <a href="https://wiki.openstack.org/wiki/Documentation/Markup_conventions">https://wiki.openstack.org/wiki/Documentation/Markup_conventions</a>:<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><b>RST</b>: Use <code><span style='font-size:10.0pt'>:command:</span></code>, <code><span style='font-size:10.0pt'>``</span></code>, <code><span style='font-size:10.0pt'>:option:</span></code>, or <code><span style='font-size:10.0pt'>:samp:</span></code>. <code><span style='font-size:10.0pt'>:samp:</span></code> allows to mark variables with curly braces.<span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'><o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>Double backtick yes, double asterisk no.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><b><span style='font-size:11.0pt;font-family:"Calibri",sans-serif'>From:</span></b><span style='font-size:11.0pt;font-family:"Calibri",sans-serif'> Olga Gusarenko [mailto:ogusarenko@mirantis.com] <br><b>Sent:</b> Tuesday, March 31, 2015 5:52 PM<br><b>To:</b> openstack-docs<br><b>Subject:</b> [OpenStack-docs] [User Guides] Conversion of the <command> tag<o:p></o:p></span></p><p class=MsoNormal><o:p> </o:p></p><div><div><p class=MsoNormal>Hi to all!<br><br>We have contrary opinions regarding the translation of the <command> XML tag to RST.<o:p></o:p></p></div><div><p class=MsoNormal>It will be great to have a single solution for everyone to keep the consistency in the docs.<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal style='margin-bottom:12.0pt'>Should the commands be wrapped in double asterisk symbol that stands for the bold text (as the commands in the xml files are bold when the sources are built)?<o:p></o:p></p></div><div><p class=MsoNormal style='margin-bottom:12.0pt'>Or should they be wrapped in double backtick symbol that stands for the monospaced text? And if so, we will have the same output for commands, options, parameters and literal.<o:p></o:p></p></div><div><p class=MsoNormal style='margin-bottom:12.0pt'>So, should it be:<o:p></o:p></p></div><div><p class=MsoNormal>a. **command**<o:p></o:p></p></div><div><p class=MsoNormal> or<o:p></o:p></p></div><div><p class=MsoNormal>b. ``command``<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Thanks for your answers in advance!<o:p></o:p></p></div><div><p class=MsoNormal>Best regards,<o:p></o:p></p></div><div><p class=MsoNormal>Olga<o:p></o:p></p></div><div><p class=MsoNormal style='margin-bottom:12.0pt'><o:p> </o:p></p></div></div></div></body></html>