-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 10/07/15 11:34, Anne Gentle wrote: > > > >> On Jul 9, 2015, at 8:25 PM, Lana Brindley >> <openst...@lanabrindley.com> wrote: >> >>>> On 08/07/15 22:41, Anne Gentle wrote: On Wed, Jul 8, 2015 at >>>> 1:16 AM, Andreas Jaeger <a...@suse.com> wrote: >>>> >>>>>> On 06/25/2015 04:10 PM, Anne Gentle wrote: >>>>>> >>>>>> For context: we are in this situation because of legal >>>>>> names, where some of the original governance allowed >>>>>> projects to use "OpenStack" in the docs as part of their >>>>>> name very early on. So, sometimes the phrasing needed >>>>>> "service" to help with readability. Also, legally we were >>>>>> required to use module due to branding with the OpenStack >>>>>> name. >>>>>> >>>>>> So, the convention is: >>>>>> >>>>>> * Uppercase first letter of first word only. * Do not >>>>>> use OpenStack in the name of the service. * Use module if >>>>>> it is consuming other services (such as heat). * Use >>>>>> service in general as that is mostly what is being added >>>>>> as projects. >>>>>> >>>>>> Now that we have the interop and brand guidelines, the >>>>>> use of OpenStack in a name in the docs is not needed, but >>>>>> we still need to be very careful and considerate in >>>>>> naming consistently. >>>>>> >>>>>> Bare metal fits our first naming rule. >>>>> Anne, I saw your comment on: >>>>> https://review.openstack.org/194230 >>>>> >>>>> So, changing to "Block storage", "Object storage", "Bare >>>>> metal" looks strange to me. But I'm neither a native >>>>> speaker nor an editor. >>>> >>>> Heh, my thinking is anything will look strange to us after >>>> editing Block Storage for years. >>>> >>>> I really don't want to get into the explanations for >>>> Key-Value vs. Key-value so I prefer the initial cap >>>> everywhere for simplicity. I'm of course open to discussion. >>>> If this list really can't imagine these guidelines working I >>>> can revisit. >>>> >>>> >>>>> >>>>> Looking forward to the patch - and perhaps a short list as >>>>> overview to review. >>>>> >>>>> Btw. did you see the thread "[openstack-dev] Should project >>>>> name be uppercase or lowercase?" >>>> >>>> >>>> I think I replied on the review then on the thread, do you >>>> see it now? > > Anne, > > I see that patch (https://review.openstack.org/#/c/194230) is now > more or less stalled. Where are we at now? > > > >> I need to do a new patch with the guidelines.
OK, cool. Let me know if you need anything from me :) L - -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iQEcBAEBAgAGBQJVnyGfAAoJELppzVb4+KUyQFQH/0byWq7ThwyH6CR4+LFcUwOk YnXosQzq7MTIlTcrpUJEPsCqu7Sh2oazstSF6916sB6dcPjBxMGxzJlaOxmF96M5 y65INrGK8nLfk70n2pVo2I60ysg5XEQvubO/7zYXZPx57ud6qld55fZsUsXneP1V afS2EGmyFNfUA/2D7LxS6S/acvd2HMpdM4hyhIB2sl9zOTqtCQBFP7p4pUeFJ8MB BwAQW22WBCf2jf5RRLNR5fScOwoSaqCj6jS0a3QrpAF0xR2bfY4Kk/uNCipSXwSy e1XQfU5StKNxdN33gyUILHGew0P76roL51qPdeujXxRPPujmOokB2Xy74Sz6rWs= =kRoQ -----END PGP SIGNATURE----- -- Mailing list: https://launchpad.net/~openstack-doc-core Post to : openstack-doc-core@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack-doc-core More help : https://help.launchpad.net/ListHelp
