- From: Yalcinalp, Umit <umit.yalcinalp@sap.com>
- Date: Thu, 12 May 2005 21:03:53 +0200
- To: <public-ws-addressing-comments@w3.org>
- Message-ID: <2BA6015847F82645A9BB31C7F9D6416505EFDC@uspale20.pal.sap.corp>
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 UTC