Comments on the WSDL 2.0 Primer

I found two issues of (limited) concern to the WS-Addressing WG in the WSDL 2.0 Primer. I also found a few typos (I cannot read any document without noting the typos :-) ).
 

1.	Typos: 

	a.	section 2.3 third para, first line: "either imported nor inlined" should be "either imported or inlined". 
	b.	section 2.4.4.1 last para under third bullet "provides examples for the URI style and Multipart style" should be "provides examples for the IRI style and Multipart style" 
	c.	section 5.1 second para: "The context that a Web service may be deployed" should probably be: "The context in which a Web service may be deployed". 

2.	Section 5.3 contains repeated use of the term "endpoint reference" in a sense which is not a WS-A EPR. It would be wise, particularly given the references in 5.2 to WS-A, to make it very clear that the endpoint reference described in 5.3 is not an End Point Reference. Or maybe a different term would be better? Something like "endpoint URL" or "endpointer"? 
3.	WS Addressing is not included in the References, despite being mentioned in section 5.2. 

I think that the WS Addressing documents should be included in the References, given the mention made of the standard. Perhaps the authors of the Primer were just waiting for our documents to reach CR?

I'm not sure how much fuss we want to make about the "endpoint reference" issue - it can be argued that it is clearly defined, and equally clearly not an EPR. At the same time, I don't think it would hurt to include a note (perhaps a footnote?) stating that this is quite explicitly not an EPR.

Tony Rogers
tony.rogers@ca.com

 

Received on Wednesday, 7 September 2005 22:20:24 UTC