<div dir="ltr">I think we should use "OpenStack Networking (neutron)" and "legacy networking (nova-network)" for titles and other "first uses" ... then simply refer to them as OpenStack Networking (or just Networking) and legacy networking for additional instances.</div>
<div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Apr 10, 2014 at 10:09 AM, Anne Gentle <span dir="ltr"><<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr">Hi all, <div>In reviewing the Install Guide edits it's clear we need some good guidance for how to refer to the continuation of two types of networking for OpenStack. </div><div><br></div><div>In <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> we have this guidance for the service and project names. We tend to adhere to this pretty well. <br>


<br>Neutron: OpenStack Networking<br><br>Generally the capitalization of the project team names like swift is lowercase. When used as a command-line-client name, lowercase is best. When used for the team or project name, typically it's not necessary to capitalize.<br>


<br>However we need to be explicit about how to refer to nova-network, the legacy networking configuration for Compute. We tend to use OpenStack Networking (neutron) and legacy networking  as needed. I also tend to put (nova-network) in parentheses so further emphasize what exactly legacy networking is. It's not precisely parallel, as there's no "nova-network" team, it's the service name.<br>


</div><div><br></div><div>Can we add guidance to the Documentation/Conventions wiki page so that reviewers have a common reference? Suggestions?</div><div><br></div><div>Thanks,</div><div>Anne</div></div>
<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>
<br></blockquote></div><br></div>