Re: [tosca] construction of URIs identifying XML namespace names

[Thomas Spatzier <thomas.spatzier@de.ibm.com>]

Hi Robin,

thanks for spotting this and pointing this out. I think this was actually
my fault. I saw the namespace definition "tosca/ns" in the template
provided to us and then had a look at the naming directives which said to
put it the other way around. Consequently, since I assumed the naming
directives are more authoritative, I changed the namespace URIs. I did not
know at that time that the naming directives were undergoing changes.

Anyway, no big deal, and I will include thoses changes shortly.

@Paul: I would consider this to be something that falls into issue TOSCA-1,
so I would just add a comment and do the change.

Regards,
Thomas
---------------------------------------------------------------------
Tivoli Service Automation Manager, Architecture & Design
Tivoli Master Inventor
IBM Deutschland Research & Development GmbH, D2705, Schoenaicher Str. 220,
D-71032 Boeblingen, Germany
thomas.spatzier@de.ibm.com | +49-7031-16-1219

IBM Deutschland Research & Development GmbH / Vorsitzende des
Aufsichtsrats: Martina Koederitz
Geschäftsführung: Dirk Wittkopp
Sitz der Gesellschaft: Böblingen / Registergericht: Amtsgericht Stuttgart,
HRB 243294


                                                                       
  From:       Robin Cover <robin@oasis-open.org>                       
                                                                       
  To:         TOSCA TC List <tosca@lists.oasis-open.org>               
                                                                       
  Cc:         Paul Lipton <paul.lipton@ca.com>, Thomas Spatzier/Germany/IBM@IBMDE, Robin Cover <robin@oasis-open.org>, Chet Ensign
              <chet.ensign@oasis-open.org>, Paul Knight <paul.knight@oasis-open.org>
                                                                       
  Date:       25.01.2012 12:40                                         
                                                                       
  Subject:    [tosca] construction of URIs identifying XML namespace names
                                                                       
  Sent by:    <tosca@lists.oasis-open.org>                             
                                                                       





TOSCA TC members,

It's great to see a high level of TC participation and early progress
on the TOSCA TC deliverables. Congratulations!

I took a peek at the Working Draft 01, and spotted one item
for early feedback.  The draft spec uses a default namespace
pattern (and derived URIs as identifiers for plan types
and DeploymentArtifact type values) using the substring
pattern "/ns/tosca/" where we expect "/tosca/ns/".

This was an understandable point of confusion because the
Naming Directives document was under revision recently.
We attempted to flag the change in the JIRA comment [1] and
in the boilerplate Starter Template sent by Paul Knight
in December [2], but the detail got lost in the weeds.

It should not be a big deal, since URIs identifying XML
namespace names and derived properties are just strings,
but for internal/operational reasons, we are asking that
the new construction pattern documented in the updated
Naming Directives [3] be followed:

  http://docs.oasis-open.org/[tc-shortname]/ns/xxxx
  [thus]
  http://docs.oasis-open.org/tosca/ns/xxxx

I spotted these instances in the WD01 draft spec:

======================================================================

I. Declared XML namespace

for:  http://docs.oasis-open.org/ns/tosca/2011/12
want: http://docs.oasis-open.org/tosca/ns/2011/12


II. plan type URIs

for:  http://docs.oasis-open.org/ns/tosca/2011/12/PlanTypes/BuildPlan
want: http://docs.oasis-open.org/tosca/ns/2011/12/PlanTypes/BuildPlan

for:  http://docs.oasis-open.org/ns/tosca/2011/12/PlanTypes/TerminationPlan
want: http://docs.oasis-open.org/tosca/ns/2011/12/PlanTypes/TerminationPlan


III. DeploymentArtifact type value (example)
for:
http://docs.oasis-open.org/ns/tosca/2011/12/deploymentArtifacts/ovfRef
want:
http://docs.oasis-open.org/tosca/2011/12/ns/deploymentArtifacts/ovfRef

Similarly for any named properties, functions, type values, etc where
these TOSCA-spec URIs are based upon the HTTP scheme URI starting
with http://docs.oasis-open.org/ (http://docs.oasis-open.org/tosca/ns/xxxx
)

======================================================================

Let me know if there are any questions.

Cheers,

- Robin

Robin Cover
OASIS, Director of Information Services
Editor, Cover Pages and XML Daily Newslink
Email: robin@oasis-open.org
Staff bio: http://www.oasis-open.org/who/staff.php#cover
Cover Pages: http://xml.coverpages.org/
Newsletter: http://xml.coverpages.org/newsletterArchive.html
Tel: +1 972-296-1783

======== References

[1] JIRA comment:
http://tools.oasis-open.org/issues/browse/TCADMIN-796?focusedCommentId=29102&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#action_29102


The XML namespace names, if HTTP scheme URIs, need to be formed
using the official tc-shortname, and respecting lower-case
thus... e.g.,
http://docs.oasis-open.org/tosca/ns/2011/12


[2] Starter Template
Starter Document for Topology and Specification for Cloud Applications
Version
1.0 (attached)
http://lists.oasis-open.org/archives/tosca/201112/msg00028.html
http://lists.oasis-open.org/archives/tosca/201112/msg00028/TOSCA-v1.0-wd01.doc

   = TOSCA-v1.0-wd01.doc

Includes on the cover page:
Declared XML namespaces:
  http://docs.oasis-open.org/tosca/ns/2011/12


[3] Naming Directives (v1.2)

XML Namespace Identifiers and Namespace Documents
http://docs.oasis-open.org/specGuidelines/ndr/namingDirectives.html#xml-namespaces

http://docs.oasis-open.org/specGuidelines/ndr/namingDirectives.html#ns-URI-string-rules



---------------------------------------------------------------------
To unsubscribe, e-mail: tosca-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: tosca-help@lists.oasis-open.org