XML schema draft comments: pt.1 3.3.2 either-or wrong, "contains" misleading

Regarding the draft at
http://www.w3.org/TR/2004/PER-xmlschema-1-20040318/:


Section 3.3.2 says:

   ... <element>s within <group> or <complexType> produce
   either particles which contain global element declarations
   (if there's a ref attribute) or local declarations
   (otherwise).

1. The "either...or" structure seems to be wrong.

    It implies "either (particles with global declarations) or
    (local declarations)".

    It seems that it was meant to imply "either (particles with
    global declarations) or (particles with local declarations)"
    (with several possible refactorings).

2. "Contain" in "contain global element declarations" implies
    that the <element> element creates a global element declaration
    in addition to creating the particle, when (I think) it actually
    creates just a particle that refers to a separately-created
    global element declaration.


Perhaps the wording should be something roughly like:

   ... <element>s within <group> or <complexType> produce
   either particles which refer to separately-declared global
   element declarations (if there's a ref attribute) or
   particles and associated local declarations (otherwise).

Actually, using singular makes things less ambiguous and
clearer:

   ... an <element> within a <group> or <complexType> produces
   either a particle which refers to a separately-declared global
   element declaration (if there's a ref attribute) or
   a particle and an associated local declaration (otherwise).


Daniel

Received on Tuesday, 15 June 2004 15:26:42 UTC