[Bug 5896] Description of particles and terms in 2.2.3.2 confusing

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





--- Comment #6 from Pete Cordell <petexmldev@codalogic.com>  2009-07-27 13:55:33 ---
Thanks Dave.  This has been illuminating to me.  The idea that 'kind' is a
special word in the vocabulary of the spec has been lost on me up until now. 
For example, where the spec says 'kinds of', such as in:

    The name [Definition:]  Component covers all the different kinds of 
    schema component defined in this specification.

I hadn't concluded that 'kind' had a special meaning and had assumed that the
sentence could equally have been written as:

    The name [Definition:]  Component covers all the different sorts of 
    schema component defined in this specification.

Or:

    The name [Definition:]  Component covers all the different forms of 
    schema component defined in this specification.

This has led to some confusion when I read things like:

    Schema Component: Attribute Declaration, a kind of Annotated Component

To which I ask, is it or isn't it an Annotated Component then?!  i.e. I read it
as:

    Schema Component: Attribute Declaration, sort of like an Annotated
Component
    but not really!

At first I thought the best way to address the confusion would be to Define
.Kind. in section 2.2, and then reference this definition in the various
headings, such as:

    Schema Component: Attribute Declaration, a .kind. of Annotated Component

But maybe it's just better to get rid of kind from the headings, e.g. do:

   Schema Component: Attribute Declaration - an Annotated Component
   Schema Component: Element Declaration - a Term


-- 
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 Monday, 27 July 2009 13:55:47 UTC