[oslc-core] Naming Conventions within ChangeLog proposal

[Martin Nally]

+1 on log namespace. I know we're in the habit of using underscore instead
of dash, but I don't like it much - can someone explain where that came
from?

I don't understand the objection to oslc-log:Creation - maybe Steve can
explain to me more before I vote.

Best regards, Martin

Martin Nally, IBM Fellow
CTO and VP, IBM Rational
tel: +1 (714)472-2690



|------------>
| From:      |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Arthur Ryman <ryman at ca.ibm.com>                                                                                                                   |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| To:        |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Steve K Speicher/Raleigh/IBM at IBMUS                                                                                                                |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Cc:        |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Martin Nally/Raleigh/IBM at IBMUS, oslc-core at open-services.net, oslc-core-bounces at open-services.net                                                  |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Date:      |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |03/22/2011 05:38 PM                                                                                                                               |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
|------------>
| Subject:   |
|------------>
  >--------------------------------------------------------------------------------------------------------------------------------------------------|
  |Re: [oslc-core] Naming Conventions within ChangeLog proposal                                                                                      |
  >--------------------------------------------------------------------------------------------------------------------------------------------------|





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