preview new text -- #2

QAWG --

We decided to deal with the unquantifiable and unverifiable "each behavior 
or requirement" in the previous Priority 1 "Examples" checkpoint by 
splitting into two ckpts.  Here is what it looks like -- a little weaker 
than it sounded on telecon, but it does solve the "each" problem...

Checkpoint 1.3. Provide examples. [Priority 1]

[@@revised0819]Illustrate behaviors or requirements in the specification by 
short and precise examples. The more numerous the          examples, the 
better it is for the specification's comprehensibility. Specifications 
should illustrate every major feature by example,          although the 
satisfaction of this checkpoint does not impose any specific relationship 
between examples, on the one hand, and          features or requirements.

Checkpoint 1.4. Ensure that every test assertion is covered by an example. 
[Priority 3]

Whereas the previous checkpoint can be satisfied by a collection of 
examples with any relationship to the requirements and          behaviors 
of the specification, this checkpoint requires that there be a mapping from 
each test assertion in the specification to an          example. The 
relationship of test assertions to examples need not be one-to-one, however 
examples should be short and precise,          for clarity and 
comprehensibility.

-Lofton.

Received on Wednesday, 14 August 2002 14:36:43 UTC