RE: Editorial Issues - Part 1

Previous Topic Next Topic
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view

RE: Editorial Issues - Part 1

Jonathan Marsh-2

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.







Jonathan Marsh - -


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




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