<div dir="ltr">Hi Akihiro,<div><br></div><div>I recently just asked this question to the mailing list myself after going through the doc conventions wiki and here is the response I received:</div><div><br></div><div><div style="font-size:13px">"The thinking here is that the team names were not trademarked nor would they ever be, so there's no reason to start rules for when to capitalize and when not to. Too many rules to track. For simplicity, always lower case the team name, the configuration file names associated with the project, the folder names, the service names, and so on. Only worry about capitalization rules when absolutely necessary. It's even why we use sentence case for titles -- there aren't additional rules to learn."</div><div style="font-size:13px"><br></div><div style="font-size:13px">I think it's best to practice what is defined on the documentation conventions wiki page which can be found here: <a href="https://wiki.openstack.org/wiki/Documentation/Conventions#Service_and_project_names">https://wiki.openstack.org/wiki/Documentation/Conventions#Service_and_project_names</a></div><div style="font-size:13px"><br></div><div style="font-size:13px">To -1 or reject things because of disagreements with written published standards adds a major stumbling block to getting things done. It's already hard enough to get things pushed through as is. New contributors only have certain standards to work from and we shouldn't make it more difficult for them to be successful at it. Thanks</div><div style="font-size:13px"><br></div><div style="font-size:13px">Shilla</div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Apr 22, 2015 at 5:44 PM, Akihiro Motoki <span dir="ltr"><<a href="mailto:amotoki@gmail.com" target="_blank">amotoki@gmail.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">This is the link of Horizon reviews I mentioned in the last mail.<br>
<a href="https://review.openstack.org/#/q/status:open+project:openstack/horizon+branch:master+topic:bug/1446253,n,z" target="_blank">https://review.openstack.org/#/q/status:open+project:openstack/horizon+branch:master+topic:bug/1446253,n,z</a><br>
<div class=""><div class="h5"><br>
2015-04-23 6:43 GMT+09:00 Akihiro Motoki <<a href="mailto:amotoki@gmail.com">amotoki@gmail.com</a>>:<br>
> Hi,<br>
><br>
> I have a question on the doc team convention on capitalization on project names.<br>
> <a href="https://wiki.openstack.org/wiki/Documentation/Conventions#Service_and_project_names" target="_blank">https://wiki.openstack.org/wiki/Documentation/Conventions#Service_and_project_names</a><br>
><br>
> Reviews which apply this convention to Horizon developer docs<br>
> are recently proposed. I would like to ask these change match<br>
> the intention of the doc team.<br>
><br>
> Personally I prefer the capitalized version of project names such as<br>
> Nova, Glance since they are normal words which have meanings<br>
> and I think capitalizing project names highlights that it is OpenStack<br>
> project names.<br>
> It is just my 2 cents.<br>
><br>
> Thanks,<br>
> Akihiro<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>
</div></div></blockquote></div><br></div></div></div>