RE: [obix] Groups - OBIX-v1.1-WD14 uploaded

The way I see it, the discussion on camel case convention is not a convention for this document. It’s a convention being described for the use of oBIX (by devices). So it needs to go into section 5 because it’s describing the way an oBIX-compliant device needs to name its objects, not the way this document is choosing to name the entities within the specification.

I agree there can be a description in section 1 about the fact that we will use capitalized names for important concepts like Object and Contract.

From: obix@lists.oasis-open.org [mailto:obix@lists.oasis-open.org] On Behalf Of Considine, Toby
Sent: Thursday, September 26, 2013 9:00 AM
To: Gemmill, Craig; obix@lists.oasis-open.org
Subject: RE: [obix] Groups - OBIX-v1.1-WD14 uploaded

I believe in Section 1 there should be a small section on document conventions, perhaps section 1.6 (although it could be before 1.5)

The discussion of CamelCasing should move there from 5.

Discussion of document conventions, such as the different meaning of Object and object, Contract and contract, should be described therein.

"When one door closes, another opens; but we often look so long and so regretfully upon the closed door that we do not see the one which has opened for us."

-- Alexander Graham Bell

Toby Considine

Chair, OASIS oBIX TC

Editor, OASIS EMIX, Energy Interoperation
Finance & Administration IT
University of North Carolina
Chapel Hill, NC

Email: Toby.Considine@ unc.edu
Phone: (919)962-9073

http://www.oasis-open.org
http://www.NewDaedalus.com

From: obix@lists.oasis-open.org [mailto:obix@lists.oasis-open.org] On Behalf Of Craig Gemmill
Sent: Thursday, September 26, 2013 8:35 AM
To: obix@lists.oasis-open.org
Subject: [obix] Groups - OBIX-v1.1-WD14 uploaded

Submitter's message
Here is a draft that contains the reorganization of Section 4. It also contains a start to the recommended changes in OBIX-30. I am interested in comments on the approach of using the term "Object" to represent the oBIX concept, and whether that is more or less confusing. Should we also apply it to other concepts like Contract? Other candidates?
-- Mr. Craig Gemmill

Document Name: OBIX-v1.1-WD14

Description
Intermediate working draft version of the spec showing sample approach to
some comments for TC discussion.
Download Latest Revision
Public Download Link

Submitter: Mr. Craig Gemmill
Group: OASIS Open Building Information Exchange (oBIX) TC
Folder: Standards
Date submitted: 2013-09-26 05:34:27
Revision: 1

obix message