<html><body><div style="color:#000; background-color:#fff; font-family:HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif;font-size:16px"><div id="yui_3_16_0_1_1434657432445_303429" dir="ltr">If we put this topic to bed now, what is the conclusion? All I see here is a "Consensus" vote of 3-3 ;-)</div><div id="yui_3_16_0_1_1434657432445_303476" dir="ltr">meg<br></div><div id="yui_3_16_0_1_1434657432445_303192"><span></span></div><br> <blockquote id="yui_3_16_0_1_1434657432445_303198" style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; margin-top: 5px; padding-left: 5px;"> <div id="yui_3_16_0_1_1434657432445_303197" style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 16px;"> <div id="yui_3_16_0_1_1434657432445_303196" style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 16px;"> <div id="yui_3_16_0_1_1434657432445_303195" dir="ltr"> <hr id="yui_3_16_0_1_1434657432445_303194" size="1"> <font id="yui_3_16_0_1_1434657432445_303479" face="Arial" size="2"> <b><span style="font-weight:bold;">From:</span></b> APlimpton <aplimpton@gmail.com><br> <b><span style="font-weight: bold;">To:</span></b> "openstack-docs@lists.openstack.org" <openstack-docs@lists.openstack.org> <br> <b><span style="font-weight: bold;">Sent:</span></b> Thursday, June 18, 2015 8:22 PM<br> <b><span style="font-weight: bold;">Subject:</span></b> Re: [OpenStack-docs] Style Question for Project Names<br> </font> </div> <div id="yui_3_16_0_1_1434657432445_303208" class="y_msg_container"><br><div id="yiv3658305900"><div id="yui_3_16_0_1_1434657432445_303207" dir="ltr">Does anyone else want to add a yea or nay about capitalizing project names before we put this topic to bed?<div id="yui_3_16_0_1_1434657432445_303482"><br></div><div id="yui_3_16_0_1_1434657432445_303484">Thanks :)</div><div id="yui_3_16_0_1_1434657432445_303426" class="yiv3658305900gmail_extra">Amanda</div><div id="yui_3_16_0_1_1434657432445_303206" class="yiv3658305900gmail_extra"><br><div id="yui_3_16_0_1_1434657432445_303205" class="yiv3658305900gmail_quote">On Mon, Jun 1, 2015 at 10:37 AM, Cannon, Chris <span dir="ltr"><<a rel="nofollow" ymailto="mailto:ccannon@hp.com" target="_blank" href="mailto:ccannon@hp.com">ccannon@hp.com</a>></span> wrote:<br><blockquote id="yui_3_16_0_1_1434657432445_303204" class="yiv3658305900gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div id="yui_3_16_0_1_1434657432445_303203" lang="EN-US">
<div id="yui_3_16_0_1_1434657432445_303202">
<div id="yui_3_16_0_1_1434657432445_303424" class="yiv3658305900MsoNormal"><span id="yui_3_16_0_1_1434657432445_303423" style="font-size:11.0pt;color:#1f497d;">I support the move to capitalize. (in case you’re keeping track)<u></u><u></u></span></div>
<div id="yui_3_16_0_1_1434657432445_303201" class="yiv3658305900MsoNormal"><span style="font-size:11.0pt;color:#1f497d;"><u></u> <u></u></span></div>
<div id="yui_3_16_0_1_1434657432445_303210" class="yiv3658305900MsoNormal"><b><span style="font-size:11.0pt;">From:</span></b><span id="yui_3_16_0_1_1434657432445_303213" style="font-size:11.0pt;"> APlimpton [mailto:<a id="yui_3_16_0_1_1434657432445_303212" rel="nofollow" ymailto="mailto:aplimpton@gmail.com" target="_blank" href="mailto:aplimpton@gmail.com">aplimpton@gmail.com</a>]
<br>
<b>Sent:</b> Monday, June 01, 2015 12:25 AM<br>
<b>To:</b> Anne Gentle<br>
<b>Cc:</b> <a id="yui_3_16_0_1_1434657432445_303422" rel="nofollow" ymailto="mailto:openstack-docs@lists.openstack.org" target="_blank" href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a></span></div><div id="yui_3_16_0_1_1434657432445_303216"><div id="yui_3_16_0_1_1434657432445_303215" class="yiv3658305900h5"><br>
<b>Subject:</b> Re: [OpenStack-docs] Style Question for Project Names<u></u><u></u></div></div><div></div><div id="yui_3_16_0_1_1434657432445_303224"><div id="yui_3_16_0_1_1434657432445_303223" class="yiv3658305900h5">
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
<div id="yui_3_16_0_1_1434657432445_303222">
<div id="yui_3_16_0_1_1434657432445_303221">
<div id="yui_3_16_0_1_1434657432445_303220">
<div id="yui_3_16_0_1_1434657432445_303219">
<div id="yui_3_16_0_1_1434657432445_303218" class="yiv3658305900MsoNormal">After reviewing the guidelines <a id="yui_3_16_0_1_1434657432445_303227" rel="nofollow" target="_blank" href="http://www.openstack.org/brand/openstack-trademark-policy/"><span id="yui_3_16_0_1_1434657432445_303226" style="font-size:9.5pt;">http://www.openstack.org/brand/openstack-trademark-policy/</span></a><u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303230">
<div id="yui_3_16_0_1_1434657432445_303229" class="yiv3658305900MsoNormal"><span id="yui_3_16_0_1_1434657432445_303232" style="font-size:9.5pt;">and <a rel="nofollow" target="_blank" href="http://www.openstack.org/brand/">http://www.openstack.org/brand/</a>, I see that there is rigor protecting and using for the OpenStack mark ("OpenStack") and logos. Interestingly
there is a non-working link in the second paragraph of the Trademark Policy page that was supposed to go to the marks themselves. Without that link working it's hard to say if the individual projects were listed there. This is also of note because the only
time I saw mention of the projects, they were capitalized: <u></u><u></u></span></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303235">
<div id="yui_3_16_0_1_1434657432445_303234" class="yiv3658305900MsoNormal"><span style="font-size:9.5pt;"><u></u> <u></u></span></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303285">
<div id="yui_3_16_0_1_1434657432445_303284" class="yiv3658305900MsoNormal"><span id="yui_3_16_0_1_1434657432445_303300" style="font-size:9.5pt;"><a id="yui_3_16_0_1_1434657432445_303299" rel="nofollow" target="_blank" href="http://www.openstack.org/brand/openstack-trademark-policy/">http://www.openstack.org/brand/openstack-trademark-policy/</a></span><u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303279">
<div id="yui_3_16_0_1_1434657432445_303278" class="yiv3658305900MsoNormal"><span id="yui_3_16_0_1_1434657432445_303282" style="font-size:9.5pt;">The "Powered by OpenStack™" Logo, shown immediately below, may be used by individuals, organizations, and companies that use formally released OpenStack Compute (Nova) code in their application or product.</span><u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303281">
<div id="yui_3_16_0_1_1434657432445_303280" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303305">
<div id="yui_3_16_0_1_1434657432445_303304" class="yiv3658305900MsoNormal"><span id="yui_3_16_0_1_1434657432445_303307" style="font-size:9.5pt;">The “Storage Powered by OpenStack™” Logo, shown immediately below, may be used by individuals, organizations, and companies that use formally released OpenStack Object Storage (Swift) code in their application
or product.</span><u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303310">
<div id="yui_3_16_0_1_1434657432445_303309" class="yiv3658305900MsoNormal">------<u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303313">
<div id="yui_3_16_0_1_1434657432445_303312" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">Having the legal policies and the majority of people using the initial uppercase strengthens the argument for updating the capitalization conventions in favor of it. <u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303297">
<div id="yui_3_16_0_1_1434657432445_303296" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303294">
<div id="yui_3_16_0_1_1434657432445_303293" class="yiv3658305900MsoNormal">Certainly the project code names are not the legal names and won't be trademarked but they are proper names and proper nouns. Since the formal/legal names for the projects are capitalized doing the same for the code names doesn't place
any importance, it just provides consistency. A friend can be named Michael but go by Mike. He wouldn't go by mike. <u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303316">
<div id="yui_3_16_0_1_1434657432445_303315" class="yiv3658305900MsoNormal">Having all mention of the project code name as lowercase does add simplicity but at the cost of accuracy and clarity. Simplicity can also be found with the proper noun is capitalized rule. It essentially boils down to "only the CLI is lowercase"
and has the added benefit of already being used commonly and provides clarity to writing.<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">Examples:<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">The Nova team has...<u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303319">
<div id="yui_3_16_0_1_1434657432445_303318" class="yiv3658305900MsoNormal">for the OpenStack Compute (code name Nova) project. Nova is the...<u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303321">
<div id="yui_3_16_0_1_1434657432445_303320" class="yiv3658305900MsoNormal">To use the nova CLI...<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">In the terminal type: nova --help <u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303324">
<div id="yui_3_16_0_1_1434657432445_303323" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303327">
<div id="yui_3_16_0_1_1434657432445_303326" class="yiv3658305900MsoNormal">All that said, I certainly agree that the legal/form name should be used when possible. Indeed the Documentation team has been doing so for years so there would be fairly little updating needed for many of those guides for a switch to an
initial capitalization. <u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303329">
<div id="yui_3_16_0_1_1434657432445_303328" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
</div>
</div>
<div id="yui_3_16_0_1_1434657432445_303330">
<div id="yui_3_16_0_1_1434657432445_303421" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div class="yiv3658305900MsoNormal">Side note: Since we have a rule for sentence capitalization for headings, would it be okay for me to add that to the Conventions page? I don't see any mention of it. <u></u><u></u></div>
</div>
</blockquote>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div class="yiv3658305900MsoNormal"> <u></u><u></u></div>
</div>
</blockquote>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div class="yiv3658305900MsoNormal">It's here:<u></u><u></u></div>
</div>
</blockquote>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div class="yiv3658305900MsoNormal"><a rel="nofollow" target="_blank" href="https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Headings">https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Headings</a> <u></u><u></u></div>
</div>
</blockquote>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div class="yiv3658305900MsoNormal">and here: <u></u><u></u></div>
</div>
</blockquote>
<blockquote id="yui_3_16_0_1_1434657432445_303381" style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div id="yui_3_16_0_1_1434657432445_303380">
<div id="yui_3_16_0_1_1434657432445_303379" class="yiv3658305900MsoNormal"><a id="yui_3_16_0_1_1434657432445_303378" rel="nofollow" target="_blank" href="https://wiki.openstack.org/wiki/Documentation/Conventions/DocBook#Headings">https://wiki.openstack.org/wiki/Documentation/Conventions/DocBook#Headings</a><u></u><u></u></div>
</div>
</blockquote>
<div id="yui_3_16_0_1_1434657432445_303384">
<div id="yui_3_16_0_1_1434657432445_303383" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">Aha, I was thinking of it as a general convention, not tool specific. Thanks for the links!<u></u><u></u></div>
</div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303420">
<div id="yui_3_16_0_1_1434657432445_303419" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303387">
<div id="yui_3_16_0_1_1434657432445_303386" class="yiv3658305900MsoNormal">Looks like consensus is currently:<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">Keep all lowercase - 3<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">Use initial uppercase - 3<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303389">
<div id="yui_3_16_0_1_1434657432445_303388" class="yiv3658305900MsoNormal">Thanks,<u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303392">
<div id="yui_3_16_0_1_1434657432445_303391" class="yiv3658305900MsoNormal">Amanda<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303396">
<div id="yui_3_16_0_1_1434657432445_303398" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
<div id="yui_3_16_0_1_1434657432445_303395">
<div id="yui_3_16_0_1_1434657432445_303394" class="yiv3658305900MsoNormal">On Sat, May 30, 2015 at 1:21 PM, Anne Gentle <<a rel="nofollow" ymailto="mailto:annegentle@justwriteclick.com" target="_blank" href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>> wrote:<u></u><u></u></div>
<blockquote id="yui_3_16_0_1_1434657432445_303402" style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div id="yui_3_16_0_1_1434657432445_303401">
<div id="yui_3_16_0_1_1434657432445_303400" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
<div id="yui_3_16_0_1_1434657432445_303409">
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
<div id="yui_3_16_0_1_1434657432445_303408">
<div class="yiv3658305900MsoNormal">On Sat, May 30, 2015 at 2:39 PM, APlimpton <<a rel="nofollow" ymailto="mailto:aplimpton@gmail.com" target="_blank" href="mailto:aplimpton@gmail.com">aplimpton@gmail.com</a>> wrote:<u></u><u></u></div>
<blockquote id="yui_3_16_0_1_1434657432445_303407" style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div id="yui_3_16_0_1_1434657432445_303406">
<div id="yui_3_16_0_1_1434657432445_303405">
<div id="yui_3_16_0_1_1434657432445_303404" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303412">
<div id="yui_3_16_0_1_1434657432445_303411" class="yiv3658305900MsoNormal">Looks like HAProxy and other pieces that are sold separately or trademarked should follow their own standard for capitalization (per IBM style guide again). <u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303415">
<div id="yui_3_16_0_1_1434657432445_303414" class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
</div>
</blockquote>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">I was going to note the same about HAProxy -- it's a proper name with associated capitalization rules. Same as your other examples, Meg.<u></u><u></u></div>
</div>
<div id="yui_3_16_0_1_1434657432445_303418">
<div id="yui_3_16_0_1_1434657432445_303417" class="yiv3658305900MsoNormal"> <u></u><u></u></div>
</div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div>
<div class="yiv3658305900MsoNormal">Thanks for the support, Meg :) Funny enough I thought this was going to be more of a case where most everyone had shifted to using the initial uppercase and the Conventions page just hadn't been updated to reflect it. Sorry to be putting
a ripple in the pond.<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
</div>
</blockquote>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">Not at all, and please don't take any of this as a personal affront or anything. I'm glad you're looking around and questioning. We love yours and Meg's fresh eyes!<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"> <u></u><u></u></div>
</div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div>
<div class="yiv3658305900MsoNormal">Given that it goes against general usage and most style guides, it would beneficial to know why the proper noun is being lowercased. I get the need to avoid making Everything Look Important, and wholeheartedly agree, but this is specifically
for one small set of names. OpenStack gets two capitalizations, the projects functional names and all the releases have a initial one. We clearly didn't disapprove of them in general, so why here? <u></u><u></u></div>
</div>
</div>
</blockquote>
<div>
<div class="yiv3658305900MsoNormal"> <u></u><u></u></div>
</div>
</div>
</div>
</div>
</blockquote>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div>
<div>
<div>
<div class="yiv3658305900MsoNormal">It's tangled up in the lack of clarity around trademark use for a couple of years. Now that there's more rigor around the use of the OpenStack trademark, how about you take a look at why you think project names should be capitalized and
post here. <u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><a rel="nofollow" target="_blank" href="http://www.openstack.org/brand/openstack-trademark-policy/">http://www.openstack.org/brand/openstack-trademark-policy/</a><u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">and<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><a rel="nofollow" target="_blank" href="http://www.openstack.org/brand/">http://www.openstack.org/brand/</a><u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">When I read through those, I still come up with the conventions we have in place. Here are my reasons pro lowercase:<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">- The team/project names like nova, swift, etc. names are never going to be trademarked so no extra import should be imparted by using the capitalize-for-proper-name convention.<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">- We don't pursue legal reasoning in trademarking the name, but do try to find a unique name that's unused in the software industry. It's not a proper name. <u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">- We have gotten cease and desist for the use of quantum for example, and by lowercasing we may be less likely to be in violation of some corner/edge legal name case.<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">- The file name such as nova.conf actually has to be lowercase in Linux-based operating systems.<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">- The nova-<name> service or daemon names also have to be lowercase in Linux-based operating systems. <u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">- The nova, swift Command Line Interface (CLI) tools also have to be run in lowercase in Linux-based operating systems. <u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">- The lower case always as a rule rather than exception helps simplify editing and guidance.<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">Side note: Since we have a rule for sentence capitalization for headings, would it be okay for me to add that to the Conventions page? I don't see any mention of it. <u></u><u></u></div>
</div>
</div>
</blockquote>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">It's here:<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><a rel="nofollow" target="_blank" href="https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Headings">https://wiki.openstack.org/wiki/Documentation/Markup_conventions#Headings</a><u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">and here:<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><a rel="nofollow" target="_blank" href="https://wiki.openstack.org/wiki/Documentation/Conventions/DocBook#Headings">https://wiki.openstack.org/wiki/Documentation/Conventions/DocBook#Headings</a><u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">Thanks,<u></u><u></u></div>
</div>
<div>
<div>
<div>
<div class="yiv3658305900MsoNormal">Anne<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal"> <u></u><u></u></div>
</div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">Thanks,<u></u><u></u></div>
</div>
<div>
<div class="yiv3658305900MsoNormal">Amanda<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
<div>
<div class="yiv3658305900MsoNormal">On Fri, May 29, 2015 at 3:24 PM, Meg McRoberts <<a rel="nofollow" ymailto="mailto:dreidellhasa@yahoo.com" target="_blank" href="mailto:dreidellhasa@yahoo.com">dreidellhasa@yahoo.com</a>> wrote:<u></u><u></u></div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;">I'll go along with the wishes of the majority but I do agree with Amanda here, that capitalizing the names of the projects<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;">would make both the writing and the reading easier.<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;">What about services that are not projects per se, such as HAProxy, MySQL, MongoDB, Pacemaker, Corosync...? Some of these exist<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;">outside the OpenStack world and everyone is used to them being capitalized in a certain way. But it seems quite awkward<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;">to capitalize these when services that are projects are not capitalized.<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;">I just went through a piece of doc and changed HAProxy to haproxy. The title of the section is "HAProxy nodes" so I had to<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;">make that "Haproxy nodes" to conform to the standard for capitalization in headers. I suppose I could rewrite it to be "The haproxy nodes"<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;">but I would much prefer to have the keyword begin the header.<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;">As I said, I'll go along but Amanda deserves a little support ;-)<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;">meg<u></u><u></u></span></div>
</div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="font-size:9.0pt;color:black;"><u></u> <u></u></span></div>
<blockquote style="border:none;border-left:solid #1010ff 1.5pt;padding:0in 0in 0in 4.0pt;margin-left:3.75pt;margin-top:3.75pt;margin-bottom:5.0pt;">
<div>
<div>
<div>
<div class="yiv3658305900MsoNormal" style="text-align:center;background:white;" align="center">
<span style="color:black;">
<hr align="center" size="1" width="100%">
</span></div>
<div class="yiv3658305900MsoNormal" style="background:white;"><b><span style="font-size:10.0pt;color:black;">From:</span></b><span style="font-size:10.0pt;color:black;"> Anne Gentle <<a rel="nofollow" ymailto="mailto:annegentle@justwriteclick.com" target="_blank" href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>><br>
<b>To:</b> APlimpton <<a rel="nofollow" ymailto="mailto:aplimpton@gmail.com" target="_blank" href="mailto:aplimpton@gmail.com">aplimpton@gmail.com</a>>
<br>
<b>Cc:</b> "<a rel="nofollow" ymailto="mailto:openstack-docs@lists.openstack.org" target="_blank" href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>" <<a rel="nofollow" ymailto="mailto:openstack-docs@lists.openstack.org" target="_blank" href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>>
<br>
<b>Sent:</b> Friday, May 29, 2015 2:56 PM<br>
<b>Subject:</b> Re: [OpenStack-docs] Style Question for Project Names</span><span style="color:black;"><u></u><u></u></span></div>
</div>
<div>
<div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
<div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">On Fri, May 29, 2015 at 4:36 PM, APlimpton <<a rel="nofollow" ymailto="mailto:aplimpton@gmail.com" target="_blank" href="mailto:aplimpton@gmail.com">aplimpton@gmail.com</a>> wrote:<u></u><u></u></span></div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">I see several people are fine with how the convention is and would prefer for it to remain as is because they do not see a need for the change. <u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">Because I do see a need, the burden is on me to further explain what I’m seeing and why it suggests that using a capital letter with the project names
is needed. <u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">When I say inconsistencies I mean that a handful of the OpenStack documentation manuals and a few wiki pages use the lowercase. On all other guides, references,
manuals, websites, pages, blogs and various other communications the capitalized letter is used by the community (OpenStack and general). This strong majority of people using the capitalized version indicates that there has been a shift in the usage and we
should update our convention accordingly. <u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">This is supported by the fact that these project names are names/proper nouns and as such should be capitalized. Having the release code names capitalized
but not the project code names is inconsistent. If the name is to be a proper noun w/ all lowercase then all sentences that start with the project name will need to be reworded (source: IBM Style Guide used per the Conventions wiki page). <u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">An additional benefit to using the initial uppercase with project names is that it helps reduce confusion. Each project uses the project name three distinct
ways with the exact same case. The project name, the CLI name and the command that is used. For example: nova, nova, nova. As a component of the project, the CLI name and the command should be lowercase (source: IBM Style Guide). Using a capitalized letter
with the project name immediately distinguishes it as being not the project component and helps make sentence creation and updating less convoluted.<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">If this makes sense to most of you and the consensus is reached to change to the initial uppercase I will be happy to find and make those changes. If
the consensus is to keep it all lowercase then I’ll go ahead and attempt correction for the majority of docs, which will take a little longer. If keeping all lowercase, it may also be a good idea to remind the other contributors about the conventions page
so they will be aware in the future. Either way I am believer in consistency and clarity. :)<u></u><u></u></span></div>
</div>
</div>
</blockquote>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">Agreed. Thanks for bringing the issue forward. Even when writing a blog post for the Rackspace blog two weeks ago, I had two editors tell me to capitalize
the project/team name. However they were fine with lowercase once I pointed out our conventions. We have the power to enforce lowercase so why not put your energy towards the lowercase preference that we've had for years?<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">One rule we have for simplicity's sake is to use sentence case for all titles, and the reasoning behind this is that it's fewer rules to explain and enforce
(plus there are two competing Title Case styles from certain references). I sense we have the same simplicity goal with "always lower case project names" because once people start uppercasing what they think is Important then Everything Is Important if you
Know what I Mean. :)<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">I'd ask you to activate towards lowercase and help enforce that as standard rather than advocating for Upper Case All the Time. <u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">Really though, I said I'd get out of the way on this one. Hope my reasoning makes sense.<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">Anne<u></u><u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"> <u></u><u></u></span></div>
</div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">Thanks,<br>
Amanda<u></u><u></u></span></div>
</div>
</div>
<div>
<div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">On Fri, May 29, 2015 at 1:37 PM, Shilla Saebi <<a rel="nofollow" ymailto="mailto:shilla.saebi@gmail.com" target="_blank" href="mailto:shilla.saebi@gmail.com">shilla.saebi@gmail.com</a>> wrote:<u></u><u></u></span></div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in;">
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">+1<br>
<br>
Sent from my iPhone<u></u><u></u></span></div>
<div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><br>
> On May 29, 2015, at 4:22 PM, Christian Berendt <<a rel="nofollow" ymailto="mailto:christian@berendt.io" target="_blank" href="mailto:christian@berendt.io">christian@berendt.io</a>> wrote:<br>
><br>
>> On 05/29/2015 09:40 PM, Andreas Jaeger wrote:<br>
>> We're following the current convention for some time already and I see<br>
>> no reason to change, let's keep the current convention. If there're<br>
>> problems, let's fix them...<br>
><br>
> +1<br>
><br>
> --<br>
> Christian Berendt<br>
> Cloud Computing Solution Architect<br>
> Mail: <a rel="nofollow" ymailto="mailto:berendt@b1-systems.de" target="_blank" href="mailto:berendt@b1-systems.de">berendt@b1-systems.de</a><br>
><br>
> B1 Systems GmbH<br>
> Osterfeldstraße 7 / 85088 Vohburg / <a rel="nofollow" target="_blank" href="http://www.b1-systems.de/">
http://www.b1-systems.de</a><br>
> GF: Ralph Dehner / Unternehmenssitz: Vohburg / AG: Ingolstadt,HRB 3537<br>
><br>
> _______________________________________________<br>
> OpenStack-docs mailing list<br>
> <a rel="nofollow" ymailto="mailto:OpenStack-docs@lists.openstack.org" target="_blank" href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <a rel="nofollow" target="_blank" href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs">
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a rel="nofollow" ymailto="mailto:OpenStack-docs@lists.openstack.org" target="_blank" href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a rel="nofollow" target="_blank" href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><u></u><u></u></span></div>
</div>
</div>
</blockquote>
</div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
</div>
</div>
<div class="yiv3658305900MsoNormal" style="margin-bottom:12.0pt;background:white;"><span style="color:black;"><br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a rel="nofollow" ymailto="mailto:OpenStack-docs@lists.openstack.org" target="_blank" href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a rel="nofollow" target="_blank" href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><u></u><u></u></span></div>
</blockquote>
</div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><br>
<br clear="all">
<u></u><u></u></span></div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;"><u></u> <u></u></span></div>
</div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">--
<u></u><u></u></span></div>
<div>
<div class="yiv3658305900MsoNormal" style="background:white;"><span style="color:black;">Anne Gentle<br>
<a rel="nofollow" ymailto="mailto:annegentle@justwriteclick.com" target="_blank" href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a><u></u><u></u></span></div>
</div>
</div>
</div>
</div>
<div class="yiv3658305900MsoNormal" style="margin-bottom:12.0pt;background:white;"><span style="color:black;"><br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a rel="nofollow" ymailto="mailto:OpenStack-docs@lists.openstack.org" target="_blank" href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a rel="nofollow" target="_blank" href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br>
<u></u><u></u></span></div>
</div>
</div>
</div>
</div>
</div>
</blockquote>
</div>
</div>
</blockquote>
</div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
</div>
</div>
</blockquote>
</div>
</div>
</div>
<div class="yiv3658305900MsoNormal"><span style="color:#888888;"><br>
<br clear="all">
<u></u><u></u></span></div>
<div>
<div class="yiv3658305900MsoNormal"><span style="color:#888888;"><u></u> <u></u></span></div>
</div>
<div class="yiv3658305900MsoNormal"><span style="color:#888888;">-- <u></u><u></u></span></div>
<div>
<div class="yiv3658305900MsoNormal"><span style="color:#888888;">Anne Gentle<br>
<a rel="nofollow" ymailto="mailto:annegentle@justwriteclick.com" target="_blank" href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a><u></u><u></u></span></div>
</div>
</div>
</div>
</blockquote>
</div>
<div class="yiv3658305900MsoNormal"><u></u> <u></u></div>
</div>
</div>
</div></div></div>
</div>
</blockquote></div><br></div></div></div><br>_______________________________________________<br>OpenStack-docs mailing list<br><a ymailto="mailto:OpenStack-docs@lists.openstack.org" 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><br><br></div> </div> </div> </blockquote> </div></body></html>