[Bug 5152] tableau presentation difficult to understand

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 UTC