RE: LC Editorial Comment for WS-Addressing Core Specification

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> 
<wsa:To>xs:anyURI</wsa:To> 
<wsa:Action>xs:anyURI</wsa:Action> 
<wsa:From>endpoint-reference</wsa:From> 
<wsa:ReplyTo>endpoint-reference</wsa:ReplyTo> 
<wsa:FaultTo>endpoint-reference</wsa:FaultTo> 

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

<wsa:MessageID> xs:anyURI </wsa:MessageID> 
<wsa:RelatesTo RelationshipType="..."?>xs:anyURI</wsa:RelatesTo> 
<wsa:To>xs:anyURI</wsa:To> 
<wsa:Action>xs:anyURI</wsa:Action> 
<wsa:From>wsa:EndpointReferenceType</wsa:From> 
<wsa:ReplyTo>wsa:EndpointReferenceType</wsa:ReplyTo> 
<wsa:FaultTo>wsa:EndpointReferenceType</wsa:FaultTo> 

 

Thanks, 

--umit 

[1] http://www.w3.org/TR/2005/WD-wsdl20-20050510/#bnfpseudoschemas
<http://www.w3.org/TR/2005/WD-wsdl20-20050510/#bnfpseudoschemas>  
[2] http://www.w3.org/TR/2005/WD-ws-addr-core-20050331/
<http://www.w3.org/TR/2005/WD-ws-addr-core-20050331/>