W3C home > Mailing lists > Public > www-ws-desc@w3.org > March 2007

Editorial Issues - Part 1

From: Ramkumar Menon <ramkumar.menon@gmail.com>
Date: Fri, 16 Mar 2007 10:22:59 -0700
Message-ID: <22bb8a4e0703161022h10d379c2j28072deb86757b69@mail.gmail.com>
To: www-ws-desc <www-ws-desc@w3.org>
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 Friday, 16 March 2007 17:23:16 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:58:46 GMT