W3C home > Mailing lists > Public > www-xml-schema-comments@w3.org > January to March 2008

[Bug 5152] tableau presentation difficult to understand

From: <bugzilla@wiggum.w3.org>
Date: Fri, 04 Jan 2008 11:41:25 +0000
CC:
To: www-xml-schema-comments@w3.org
Message-Id: <E1JAkvV-0003FS-Oa@wiggum.w3.org>

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





------- Comment #4 from petexmldev@tech-know-ware.com  2008-01-04 11:41 -------
Taking into accout Mike's comments in Bug #5152, a variation on John's last
proposal would be to include alternative schema components in separate
sections.  For example, a document structure could be:

3.2.2 XML Representation of Attribute Declaration Schema Components
    XML Representation Summary table

3.2.2.1 Global Attribute Schema Component
    Para: If the <attribute> element information item has <schema> ... 
    then table

3.2.2.2 Local Attribute Schema Component
    Para: If the <attribute> element information item has <complexType> as... 
    (I've removed the initial 'Otherwise'.)
    then table

3.2.2.3 Referenced Attribute Schema Component
    Para: If the <attribute> ... has <complexType> ... and the ref 
    then table

Note that I've intentionally used the section heading to give a little clue as
to what the particular sub-section is about.

BTW I think the structure here is easiest to understand if it has the form:

    if(...) {
    }
    if(...) {
    }
    if(...) {
    }

i.e. each condition is stand-alone, rather than:

    if(...) {
    }
    else if(...) {
    }
    else {
    }
Received on Friday, 4 January 2008 11:41:28 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Sunday, 6 December 2009 18:13:12 GMT