This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 4421 - Editorial Issues - Part 1
Summary: Editorial Issues - Part 1
Status: CLOSED FIXED
Alias: None
Product: WSDL
Classification: Unclassified
Component: Core (show other bugs)
Version: 2.0
Hardware: All All
: P2 minor
Target Milestone: ---
Assignee: Philippe Le Hegaret
QA Contact: WSDL Mailing List
URL: http://lists.w3.org/Archives/Public/w...
Whiteboard:
Keywords: resolved
Depends on:
Blocks:
 
Reported: 2007-03-29 16:58 UTC by Jonathan Marsh
Modified: 2007-04-26 13:00 UTC (History)
0 users

See Also:


Attachments

Description Jonathan Marsh 2007-03-29 16:58:27 UTC
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 .
Comment 1 Jonathan Marsh 2007-03-29 17:07:18 UTC
Per http://lists.w3.org/Archives/Public/www-ws-desc/2007Mar/att-0083/20070329-ws-desc-minutes.html#item06, we will:

- Rename 1.1 to "Service Description"
- Fix the incorrect prefix as proposed.
- Change "At the abstract level" to "At a high level"