W3C home > Mailing lists > Public > public-ws-addressing-comments@w3.org > June 2005

RE: LC Editorial Comment for WS-Addressing Core Specification

From: Jonathan Marsh <jmarsh@microsoft.com>
Date: Mon, 13 Jun 2005 11:07:37 -0700
Message-ID: <7DA77BF2392448449D094BCEF67569A507DCE488@RED-MSG-30.redmond.corp.microsoft.com>
To: "Yalcinalp, Umit" <umit.yalcinalp@sap.com>, <public-ws-addressing-comments@w3.org>
Thank you for your comment, tracked as LC106 [1].  The WG agreed to
conform to the pseudo-schema notation defined in WSDL 2.0, which
notation has been fixed to illustrate element simpleType content.


[1] http://www.w3.org/2002/ws/addr/lc-issues/#lc106




From: public-ws-addressing-comments-request@w3.org
[mailto:public-ws-addressing-comments-request@w3.org] On Behalf Of
Yalcinalp, Umit
Sent: Thursday, May 12, 2005 12:04 PM
To: public-ws-addressing-comments@w3.org
Subject: LC Editorial Comment for WS-Addressing Core Specification


This is an editorial comment. 

WSD wg has adopted a BNF style for designating pseudo schemas and used
in WSDL 2.0 specifications consistently. The definition is available in
the current WSDL 2.0 Core Language specification [1], in section 1.4.8.
Using this style differentiates a pseudo schema from an actual example
that contains a concrete schema or a document fragment. Further, it
improves the readibility of the pseudo schemas. The values of attributes
and elements are designated by schema types in italics when actual
values are not used. 

I propose the wg to adopt the same pseudo schemas style to improve the
readability of Example 2.1 and Example 3.1 in the WS-Addressing Core
Specification [2] and whenever pseudo schemas are needed in the future
for other WS-Addressing specs. I recommend referring to WSDL 2.0 Core
Language specification for examples throughout. 

As an example, Example 3.1 states the following: 

<wsa:MessageID> xs:anyURI </wsa:MessageID> 
<wsa:RelatesTo RelationshipType="..."?>xs:anyURI</wsa:RelatesTo> 

By adopting the style, xs:anyURI would be in italics,
"endpoint-reference" should be replaced by wsa:EndpointReferenceType in

<wsa:MessageID> xs:anyURI </wsa:MessageID> 
<wsa:RelatesTo RelationshipType="..."?>xs:anyURI</wsa:RelatesTo> 




[1] http://www.w3.org/TR/2005/WD-wsdl20-20050510/#bnfpseudoschemas
[2] http://www.w3.org/TR/2005/WD-ws-addr-core-20050331/
Received on Monday, 13 June 2005 18:08:37 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 19:49:00 UTC