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

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

From: David Booth <dbooth@w3.org>
Date: Thu, 14 Apr 2005 16:34:49 -0400
Message-Id: <5.1.0.14.2.20050413134527.02616d28@localhost>
To: public-ws-desc-comments@w3.org
Cc: dbooth@w3.org

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 GMT

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