W3C home > Mailing lists > Public > www-qa@w3.org > October 2002

Re: TOC checkpoints

From: Lynne Rosenthal <lynne.rosenthal@nist.gov>
Date: Fri, 25 Oct 2002 20:16:13 -0400
Message-Id: <5.1.0.14.2.20021025200012.00b13208@mailserver.nist.gov>
To: www-qa@w3.org
After some thought - I believe that the "Include a TOC" checkpoints are 
really techniques and not a checkpoint.  The goal is:
LH>Our goal is this:  it should be easy for the user to find all of the
LH>information necessary to understand the conformance policy and all of
LH>its details, regardless of spec partitioning.

and the checkpoint should reflect this.

I also agree with lofton's
LH>I have been thinking whether we could unify all of these somehow...

So, I would like to see 1 checkpoint that captures the goal and have that 
checkpoint in 1 place. This eliminates the need to repeat the checkpoint in 
every DoV-related section, it ensures that any non-DoV items that could 
affect the conformance policy would also be covered by the checkpoint, and 
we don't need to worry about specs that may not have a TOC.

regards
Lynne

To: &References="www-qa-wg@w3.org
Message-ID: <OFD9237533.F87D0959-ON85256C5D.005F92F9@lotus.com>
From: David Marston/Cambridge/IBM <&References="david_marston@us.ibm.com>
Date: Fri, 25 Oct 2002 13:51:30 -0400
Subject: Re: TOC checkpoints


LH>A TOC entry is required for each of checkpoints 3.1, 4.1, 5.1, 7.5,
LH>8.5, 9.7, 10.10 (note numbering problem).

Numbering note: GL 6 is one of the DoV, but its TOC requirement is
expressed in GL 10.

LH>Our goal is this:  it should be easy for the user to find all of the
LH>information necessary to understand the conformance policy and all of
LH>its details, regardless of spec partitioning.

...or navigation mechanism, as LH later mentions...

LH>I have been thinking whether we could unify all of these somehow...

That seems cleaner, but it revives the "negative mention" issue. The
problem can be solved, but I gather that the sentiment is to be less
strident about the requirement.

Here's a restatement of what I, as a Quality Engineer, would want:
Given a spec document, I should be able to
(1) identify and retrieve all the other normative documents that
     have bearing on this spec, then
(2) identify a TOC or other navigation mechanism that allows me to
     locate either
(3A) the conformance section [Ck 10.9 satisfied] or at least
(3B) the conformance clause [Ck 10.8 satisfied],
and from that conformance material
(4) either read or navigate to all the material about conformance
     variability. For *each* of the 8 DoV, I should be able to
     determine unambiguously either
(5A) that the dimension allows no variability, or
(5B) the extent of the allowed variability.

Of course, (5A) could be satisfied unambiguously without a negative
statement if the conformance clause/section has a statement of the
form: "The only ways in which implementations are allowed to vary
from one another are..." and then goes on to mention those DoV that
are used.

Is "unambiguous" more precise than "clear"? If not, we need specs on
the comprehension capabilities of the "intended readers" of W3C
Technical Reports.
.................David Marston
Received on Friday, 25 October 2002 20:16:22 GMT

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