<div dir="ltr">ALLCAPS sounds good to me! Shout it out!</div><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Apr 21, 2014 at 12:21 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:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">In the Install Guide, we normally write VALUE all in caps in<br>
replaceables - with the exception of the hostname "controller". Is this<br>
a convention we want to use in the rest of the repos as well? I know we<br>
have different styles currently - including using "<value>" - but<br>
I would favor to have a common style used in all manuals and slowly<br>
converge to it.<br>
<br>
This was triggered by Diane asking me in<br>
<a href="https://review.openstack.org/#/c/89286/" target="_blank">https://review.openstack.org/#/c/89286/</a> to use<br>
"<replaceable>PASSWORD</replaceable>" and then reviewing<br>
<a href="https://review.openstack.org/#/c/89294/1/doc/common/section_cli_nova_customize_flavors.xml" target="_blank">https://review.openstack.org/#/c/89294/1/doc/common/section_cli_nova_customize_flavors.xml</a><br>
which uses for example "<replaceable>flavorName</replaceable>" in line 261.<br>
<br>
So, my question:<br>
<br>
Is everybody fine with me adding the all-caps convention to the<br>
Conventions page?<br>
<span class="HOEnZb"><font color="#888888"><br>
Andreas<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 Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)<br>
GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<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>
</font></span></blockquote></div><br></div>