Misc Part1 editorial issues

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 UTC