[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