Re: XML schema draft comments: pt.1 4.2.1 <include>d

I wrote:

> Regarding the draft at
> http://www.w3.org/TR/2004/PER-xmlschema-1-20040318/:
> 
> Section 4.2.1 says:
> 
>   ... all the components of all the ·XML Schemas· corresponding
>   to any <include>d schema documents.
> 
> AGH!!!
> 
> The notation "<include>" has meant "include element."  Using it
> as a verb (or punctuation the verb "include" as an element name)
                           ^ punctuating
> is confusing, or at least jarring.

Especially consider the density of occurrences of that form in
the next sentence:

   Such included schema documents must either (a) have the same
   targetNamespace as the <include>ing schema document, or (b) no
   targetNamespace at all, in which case the <include>d schema
   document is converted to the <include>ing schema document's
   targetNamespace.


> Just say "corresponding to any included schema documents" 

... as already done at the beginning of that second sentence.

Daniel

Received on Wednesday, 16 June 2004 14:21:05 UTC