Editorial: Ambiguous use of the terms "include" and "import"

Part 1 uses the words "include" and "import" in several places without 
being clear about whether they are referring to wsdl:include and 
wsdl:import or xs:include and xs:import.

In fact, these terms appear to be used in two different ways in the same 
table, in some cases referring to the wsdl: versions, and in other cases 
referring to the xs: versions.  For example, in the table in sec 2.1.3 
"Mapping Description's XML Representation to Component Properties"
http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/wsdl20/wsdl20.html?content-type=text/html;%20charset=utf-8#Description_Mapping
the entry for {type definitions} says:

         ". . . plus any imported type definitions . . .",

which (I think) is referring to xs:import, whereas the entry for 
{interfaces} says:

         ". . . plus any included or imported Interface components . . ."

which is referring to wsdl:include and wsdl:import.

I think it would be good to look throughout the document at how these terms 
are used, and disambiguate each usage, such as writing "included via 
wsdl:include" instead of simply "included".


-- 
David Booth
W3C Fellow / Hewlett-Packard
Telephone: +1.617.253.1273

Received on Friday, 15 April 2005 14:43:10 UTC