[Openstack-docs] Identity component instead of service?

Lana Brindley openstack at lanabrindley.com
Wed Jun 4 03:38:43 UTC 2014


Why?

L

On 04/06/14 13:30, Matt Kassawara wrote:
> I also suggest "service" for chapters and "component" for parts within a
> chapter that make up the service. For example, Networking has the
> server, ML2 plug-in, and layer 3 components.
>
>
> On Tue, Jun 3, 2014 at 8:53 PM, Matt Kassawara <mkassawara at gmail.com
> <mailto:mkassawara at gmail.com>> wrote:
>
>     I suggest using "add" for general chapters and words such as
>     "install", "configure", and "verify" for sections within them.
>
>
>     On Tue, Jun 3, 2014 at 6:37 PM, Alexandra Settle
>     <alexandra.settle at rackspace.com
>     <mailto:alexandra.settle at rackspace.com>> wrote:
>
>         Thanks everyone for the feedback.
>
>         Are you suggesting we keep it as ³Configure the Identity service² or
>         change the phrasing of the second option to, ³Add the Identity
>         service²?
>
>         The change was implemented as a part of the Install Guide
>         Improvements
>         lead by Matt Kassawara.
>         (https://wiki.openstack.org/wiki/Documentation/InstallationGuideImprovement
>         s) My adjustment to the title was as his suggestion (but, as
>         written, only
>         a suggestion). So of course, happy to change.
>
>
>
>         On 3/06/2014 8:04 pm, "Andreas Jaeger" <aj at suse.com
>         <mailto:aj at suse.com>> wrote:
>
>          >On 06/03/2014 11:01 AM, Christian Berendt wrote:
>          >> On 06/02/2014 08:57 PM, Andreas Jaeger wrote:
>          >>> For me it's really "Identity service" and not "Identity
>         component".
>          >>
>          >> At the moment "Identity component" is not used in
>         openstack-manuals at
>          >> all so I think we should not introduce it.
>          >>
>          >> We should define and document if we want to use "XYZ
>         service" or "XYZ
>          >> Service" and should change all occurrence. I would prefer
>         "XYZ service".
>          >
>          >This is already documented - it's "Image Service" (official
>         name) and
>          >otherwise "service" - in the Conventions page,
>          >
>          >Andreas
>          >--
>          > Andreas Jaeger aj@{suse.com <http://suse.com>,opensuse.org
>         <http://opensuse.org>} Twitter: jaegerandi
>          >  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>          >   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG
>         Nürnberg)
>          >    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C
>         C272 A126
>          >
>          >_______________________________________________
>          >Openstack-docs mailing list
>          >Openstack-docs at lists.openstack.org
>         <mailto:Openstack-docs at lists.openstack.org>
>          >http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>
>         _______________________________________________
>         Openstack-docs mailing list
>         Openstack-docs at lists.openstack.org
>         <mailto:Openstack-docs at lists.openstack.org>
>         http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>
>
>
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>


-- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com



More information about the Openstack-docs mailing list