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: <>
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"
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

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:31:01 UTC