[Bug 11228] New: minor editorial improvement : definition of particles

http://www.w3.org/Bugs/Public/show_bug.cgi?id=11228

           Summary: minor editorial improvement : definition of particles
           Product: XML Schema
           Version: 1.1 only
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: minor
          Priority: P2
         Component: Structures: XSD Part 1
        AssignedTo: David_E3@VERIFONE.com
        ReportedBy: gandhi.mukul@gmail.com
         QAContact: www-xml-schema-comments@w3.org
                CC: cmsmcq@blackmesatech.com


The latest editor's draft of XML Schema 1.1 spec (ref,
http://www.w3.org/XML/Group/2004/06/xmlschema-1/structures.omni.20101029.html)
says in the section "3.9.2 XML Representation of Particle Schema Components":

<quote>
Particles correspond to all three elements (<element> not immediately within
<schema>, <group> not immediately within <schema> and <any>)
</quote>

The phrase "all three elements" confuses me a bit (word *elements* in "three
elements" confuses me with say a formal term "element declaration" in the XSD
spec. It seems to me that the intent of the editors here is to denote "three
elements" to the XML tags specified in the bracket just after that; but this
confuses me). 

I think if the above cited phrase is changed to a text like following, then the
meaning of the cited phrase would be more obvious to readers:

<new>
Particles correspond to all three schema instructions (<element> not
immediately within <schema>, <group> not immediately within <schema> and <any>)
</new>

i.e I would propose a phrase like "schema instructions" as replacement of text
"three elements" in this section of the spec.

-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.

Received on Friday, 5 November 2010 00:35:03 UTC