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

LC Editorial Comment for WS-Addressing Core Specification

From: Yalcinalp, Umit <umit.yalcinalp@sap.com>
Date: Thu, 12 May 2005 21:03:53 +0200
Message-ID: <2BA6015847F82645A9BB31C7F9D6416505EFDC@uspale20.pal.sap.corp>
To: <public-ws-addressing-comments@w3.org>
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
[2] http://www.w3.org/TR/2005/WD-ws-addr-core-20050331/
Received on Thursday, 12 May 2005 19:06:37 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:19:38 GMT