[Openstack-docs] Conventions on naming

Steve Gordon sgordon at redhat.com
Tue Feb 4 23:17:14 UTC 2014


----- Original Message -----
> From: "Anne Gentle" <anne.gentle at rackspace.com>
> To: openstack-docs at lists.openstack.org
> Sent: Tuesday, February 4, 2014 5:24:44 PM
> Subject: [Openstack-docs] Conventions on naming
> 
> Hi all,
> Based on today's Technical Committee meeting and conversations with the
> OpenStack board members, I need to change our Conventions for service names
> at
> https://wiki.openstack.org/wiki/Documentation/Conventions#Service_and_project_names
> .
> 
> Previously we have indicated that Ceilometer could be named OpenStack
> Telemetry and Heat could be named OpenStack Orchestration. That's not the
> case, and we need to change those names.
> 
> To quote the TC meeting, ceilometer and heat are "other modules" (second
> sentence from 4.1 in
> http://www.openstack.org/legal/bylaws-of-the-openstack-foundation/)
> distributed with the Core OpenStack Project.
> 
> Here's what I intend to change the wiki page to:
>  Here's the list of project and module names and their official names and
> capitalization:
> 
> Ceilometer module
> Cinder: OpenStack Block Storage
> Glance: OpenStack Image Service
> Heat module
> Horizon: OpenStack dashboard
> Keystone: OpenStack Identity Service
> Neutron: OpenStack Networking
> Nova: OpenStack Compute
> Swift: OpenStack Object Storage
> 
> I'll also add trove which is moving to integrated in the Icehouse release.
> It'll be the Trove module because of the wording from the bylaws, "The
> other modules which are part of the OpenStack Project, but not the Core
> OpenStack Project may not be identified using the OpenStack trademark
> except when distributed with the Core OpenStack Project."
> 
> Please let me know if this will cause more confusion (I'm sure it will) and
> how to give guidance for revisions.

What's the reason for calling them the "Ceilometer module" and "Heat module" rather than just dropping the trademarked term ("OpenStack") and calling them the "Telemetry Service" and the "Orchestration Service"? I assume you are extrapolating to use "module" based on the verbage in the by law but it seems heavy handed given the aim seems to be getting rid of the trademarks (that and the fact that I haven't seen us use "module" in relation to project names anywhere at all previously regardless of core v integrated v incubating status). It also seems premature as I also can't find mention of the two names proposed anywhere in the logs of the TC meeting.

I note from that by law that "The Secretary shall maintain a list of the modules in the Core OpenStack Project which shall be posted on the Foundation’s website.". What's the link to that, because http://www.openstack.org/software/openstack-shared-services/ refers to the Telemetry Service and Orchestration service. I was under the understanding the Wiki page at https://wiki.openstack.org/wiki/Programs wasn't authoritative as far as reflecting the boards opinion but if neither of these are the right one, where is it?

Basically I'd like to ensure that there is consensus on the "new" names to use across the community rather that jumping to change them and then have to do it again later.

Thanks,

Steve



More information about the Openstack-docs mailing list