On Wed, Jan 25, 2012 at 7:03 AM, Thomas Spatzier <
thomas.spatzier@de.ibm.com > wrote: 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. Excellent, and not your "fault" at all, since our documentation was inconsistent, and you made a reasonable choice. My fault! I'm pleased that you consulted the Naming Directives document and were trying to follow its guidelines. The spec seems to be coming along very nicely: congrats! - 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/people/staff/robin-cover Cover Pages:
http://xml.coverpages.org/ Newsletter:
http://xml.coverpages.org/newsletterArchive.html Tel: +1 972-296-1783 @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 -- 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/people/staff/robin-cover Cover Pages:
http://xml.coverpages.org/ Newsletter:
http://xml.coverpages.org/newsletterArchive.html Tel: +1 972-296-1783