RE: Editorial Issues - Part 1

Thank you for this issue.  We tracked it as Issue 4421 [1] in our short Last Call period.  The Working Group renamed section 1.1 to “Web Service” to “Service Description” [2], fixed the incorrect prefix in 1.4.5 [3], and changed “At the abstract level” to “At a high level” [4].

 

The spec should be in Proposed Recommendation shortly, if you disagree with the resolution of this issue please inform us as soon as possible.

 

[1] http://www.w3.org/Bugs/Public/show_bug.cgi?id=4421  

[2] http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/wsdl20/wsdl20.html?content-type=text/html;%20charset=utf-8#intro_ws

[3] http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/wsdl20/wsdl20.html?content-type=text/html;%20charset=utf-8#terminology 

[4] http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/wsdl20/wsdl20.html?content-type=text/html;%20charset=utf-8#Description_details 

 

Jonathan Marsh -  <http://www.wso2.com> http://www.wso2.com -  <http://auburnmarshes.spaces.live.com> http://auburnmarshes.spaces.live.com

 

From: www-ws-desc-request@w3.org [mailto:www-ws-desc-request@w3.org] On Behalf Of Ramkumar Menon
Sent: Friday, March 16, 2007 10:23 AM
To: www-ws-desc
Subject: Editorial Issues - Part 1

 

Gurus,

 

Please find the following editorial issues that I find in Part 1.

 

1) Why is 1.1 titled "Web Service" ? It does not describe what a Web Service is. It describes in summary on how WSDL describes a Web Service.  Perhaps it should be titled "Service Description" or something on those lines 
.
2)  1.4.5 --> Inlined Schema
statement - "An XML schema that is defined in the xs:types element information item of a WSDL 2.0 description."  

suggestion -  It should be "wsdl:types" and not "xs:types".


3) Section 2.1.1 

Statement in the spec :-  "At the abstract level, the Description component is just a container for two categories of components: WSDL 2.0 components and type system components.WSDL 2.0 components are interfaces, bindings and services. ".  

Suggestion :-   This gives a message that bindings and services exist at the abstract level. Is it true ? Moreover, the first sentence seems to suggest that the later part of the section will go and quote the Description component at the concrete level - which is missing . 



-- 
Shift to the left, shift to the right!
Pop up, push down, byte, byte, byte!

-Ramkumar Menon
A typical Macroprocessor 

Received on Thursday, 10 May 2007 16:10:59 UTC