[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [obix] oBIX Artifact Naming and Titling...Artifact Names
Artifact names, in OASIS, is the file names. As they are often used in urls, they should be case-insensitive for the widest standard applicability. Lower-case, as you suggested, seems fine:
Editors:
Starting with the next upload, can we have all file names be lower case as in
obix-rest-v1.0-csd01.doc
obix-soap-v1.0-csd01.doc
obix-encodings-v1.0-csd01.doc
obix--v2.0-csd01.doc
etc. The same rule should apply to the wsdl artifacts.
Thanks
tc
"If something is not worth doing, it`s not worth doing well " -- Peter Drucker
Toby Considine
TC9, IncOASIS TC Chair: oBIX & WS-Calendar
OASIS TC Editor: EMIX, Energy Interoperation
SGIP Smart Grid Architecture Committee
Email: Toby.Considine@gmail.com
Phone: (919)619-2104
From: Paul Knight [mailto:paul.knight@oasis-open.org]
Sent: Thursday, April 18, 2013 5:16 PM
To: Considine, Toby
Cc: tcadmin@lists.oasis-open.org; obix@lists.oasis-open.org
Subject: Re: [obix] oBIX Artifact Naming and Titling...
Hi Toby and all,
Thanks for asking. It's certainly best to think about these things before publication!
.
.
.
- for the document file names and URIs, the currently-planned names are:
These file names do not need to follow the capitalization pattern of the titles (OBIX or oBIX). Since the handling of file names is case-sensitive, it's quite important to keep the naming regular. I would highly recommend using all lower-case file names. For those times when they are manually typed, it simplifies things considerably, and I think it has a neater appearance. However, we can support whatever the TC agrees for file names. Please make a specific choice for these file names, as well as for the titles.
Enough for now... please feel free to ask for clarification, support, etc.
Best regards,
Paul
On Thu, Apr 18, 2013 at 1:07 PM, Considine, Toby <Toby.Considine@unc.edu> wrote:
Advice needed, requested after considerable discussion in oBIX TC.
(This might be a Paul Knight question)
oBIX 1.0 is an omnibus specification. In 1.1 we are breaking out two bindings, (SOAP and REST), and Encodings (XML, JSON, COAP, et al.) We anticipate that a Conforming 1.1 Server MUST specify which Bindings, Encodings it supports. We anticipate that at a future time, a new encodings document could be made, or a new binding, without creating a 1.2. Conversely, we can imagine oBIX 1.2 coming out and referencing the Binding/Encoding documents we are working on today.
As a matter of work process, the current WDs of each specification are essentially stripped out of the old 1.0. Each spec is currently being modified as needed. We anticipate releasing a package of 4 specifications (oBIX 1.1, SOAP Binding for oBIX, REST Binding for oBIX, Encodings for oBIX) in the same public review.
There was a spirited discussion today about avoiding confusion. Should they all be 1.1 of the Spec, because they all existed formerly as part of 1.0? Should they have longer titles, i.e.,
· “SOAP Bindings for oBIX 1.1 and above, v1.0”
· “SOAP Bindings for oBIX 1.1, v1.0”
Of course, the answer could also be
· “SOAP Bindings for oBIX 1.1 and above, v1.1”
· “SOAP Bindings for oBIX 1.1, v1.1”
With each document noting that the original material was all included in 1.0.
We are looking for advice on how to avoid as much confusion as possible while still allowing for flexibility going forward.
Thanks
tc
"You can cut all the flowers but you cannot keep spring from coming."
-Pablo Neruda
Toby Considine
Chair, OASIS oBIX TC
Editor, OASIS EMIX, Energy Interoperation
Campus Services Information Technology
University of North Carolina
Chapel Hill, NC
Email: Toby.Considine@ unc.edu
Phone: (919)962-9073
--
Paul Knight - Tel: +1 781-861-1013
OASIS - Advancing open standards for the information society
Document Process Analyst
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]