[oslc-core] Naming Conventions within ChangeLog proposal
Arthur Ryman
ryman at ca.ibm.com
Tue Mar 22 17:38:38 EDT 2011
Steve,
+1 for the log namespace.
-1 for CreateEvent - there should be a standard meaning for resource
creation.
Regards,
___________________________________________________________________________
Arthur Ryman, PhD, DE
Chief Architect, Project and Portfolio Management
IBM Software, Rational
Markham, ON, Canada | Office: 905-413-3077, Cell: 416-939-5063
From:
Steve K Speicher <sspeiche at us.ibm.com>
To:
Martin Nally <nally at us.ibm.com>, oslc-core at open-services.net
Date:
03/22/2011 05:14 PM
Subject:
Re: [oslc-core] Naming Conventions within ChangeLog proposal
Sent by:
oslc-core-bounces at open-services.net
Might I suggest a couple alternatives to these as well:
> oslc:create -> oslc:Creation
This seems too general, is this what we want all of OSLC Core to mean by
Creation?
-> oslc:CreateEvent
Include more descriptive noun, since in general core namespace
-> oslc_log:Creation
Same as proposed but included within some change log namespace
> oslc:update -> oslc:Modification
> oslc:delete -> oslc:Deletion
Same as above
Thanks,
Steve Speicher | IBM Rational Software | (919) 254-0645
> From: Martin Nally/Raleigh/IBM at IBMUS
> To: oslc-core at open-services.net
> Cc: oslc-core at open-services.net, oslc-core-bounces at open-services.net
> Date: 03/22/2011 10:20 AM
> Subject: Re: [oslc-core] Naming Conventions
> Sent by: oslc-core-bounces at open-services.net
>
> While we're at it we could maybe improve the grammar. It would feel
better
> to me if the terms chosen looked more like nouns than verbs - saying
> something is "a oslc:Create" is awkward. How about the following
>
> oslc:create -> oslc:Creation
> oslc:update -> oslc:Modification
> oslc:delete -> oslc:Deletion
>
> It would be nice to e able to say "an" instead of just "a", but we can't
do
> that without W3C.
>
> Best regards, Martin
>
> Martin Nally, IBM Fellow
> CTO and VP, IBM Rational
> tel: +1 (714)472-2690
>
> >
> > Message: 1
> > Date: Mon, 21 Mar 2011 15:25:58 -0400
> > From: Arthur Ryman <ryman at ca.ibm.com>
> > To: oslc-core at open-services.net
> > Subject: [oslc-core] ChangeLog Vocabulary and Naming Conventions
> > Message-ID:
> > <OFC44196C7.0847D24D-ON8525785A.00699988-8525785A.006AC098 at ca.ibm.com>
> > Content-Type: text/plain; charset="US-ASCII"
> >
> > This is a very tiny point.
> >
> > The naming convention for vocabulary terms is that classes and
> individuals
> > begin with upper case, and properties begin with lower case. If we
want
> to
> > align with that, then we should uppercase terms as follows:
> >
> > oslc:Create
> > oslc:Update
> > oslc:Delete
> >
> > Regards,
> >
>
___________________________________________________________________________
>
> >
> > Arthur Ryman, PhD, DE
> >
> > Chief Architect, Project and Portfolio Management
> > IBM Software, Rational
> > Markham, ON, Canada | Office: 905-413-3077, Cell: 416-939-5063
> >
>
>
> _______________________________________________
> Oslc-Core mailing list
> Oslc-Core at open-services.net
> http://open-services.net/mailman/listinfo/oslc-core_open-services.net
_______________________________________________
Oslc-Core mailing list
Oslc-Core at open-services.net
http://open-services.net/mailman/listinfo/oslc-core_open-services.net
More information about the Oslc-Core
mailing list