W3C home > Mailing lists > Public > public-ws-desc-comments@w3.org > April 2005

Misc Part1 editorial issues

From: David Booth <dbooth@w3.org>
Date: Mon, 04 Apr 2005 13:51:59 -0400
To: public-ws-desc-comments@w3.org
Message-Id: <1112637119.4338.19873.camel@nc6000.w3.org>

Misc Part1 editorial issues:

1. Typos:
s/modularize a a given component/modularize a given component/
s/unless the are imported/unless they are imported/

2. The mappings from the XML Infoset-->Component Properties are
unidirectional in WSDL 2.0 -- not bidirectional.  (We do not define a
mapping back from Component Properties-->XML Infoset.)  This should be
clearer whenever these mappings are mentioned.  Therefore, phrases like
(in sec 2.1.3):
[[
The mapping between the properties of the Description component (see
2.1.1 The Description Component) and the XML Representation of the
description element information item . . . .
]]
should be reworded to something like:
[[
The mapping from the XML Representation of the description element
information item to the properties of the Description component (see
2.1.1 The Description Component) . . . .
]]

This occurs in a quite a number of places, and should be corrected
throughout.  Here is another example:
[[
Table 2-1. Mapping between Description Component Properties and XML
Representation
]]
should be something like:
[[
Table 2-1. Mapping from XML Representation to Description Component
Properties
]]

3. In all of the Infoset-->Component Property mapping tables (such as
Table 2-1), I suggest changing the column headings from "Property" and
"Mapping" to something like "Property Name" and "Property Value (Mapping
from Infoset)", in order to be more clearly descriptive.


-- 

David Booth
W3C Fellow / Hewlett-Packard
Received on Monday, 4 April 2005 17:52:05 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:20:31 GMT