[Bug 5195] Editorial comments on section 3.4.4

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

           Summary: Editorial comments on section 3.4.4
           Product: XML Schema
           Version: 1.1 only
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Structures: XSD Part 1
        AssignedTo: cmsmcq@w3.org
        ReportedBy: mike@saxonica.com
         QAContact: www-xml-schema-comments@w3.org


The first paragraph starts discussing the CTD of both elements and attributes,
and then it seems to forget about attributes in mid-sentence and discuss
elements only. It comes back to attributes about a page later, by which time
it's hard to pick up the thread. (Perhaps you should take attributes first, as
they are simpler.)

Validation Rule: Element Locally Valid (Complex Type)

In rule 1, the use of the past tense in "did not apply" implies some kind of
order of evaluation of the rules. Is the meaning different from "does not
apply"? If there's a dependency here then it should be explicit, not darkly
hinted at. Alternatively, factor out the rule.

In rule 4, there seems to be some rogue capitalization of terms like "Attribute
Use" and "Attribute Declaration". 

In rule 4.5, "does not match one" should be "does not match any" to avoid
ambiguity.

Received on Sunday, 14 October 2007 23:05:42 UTC