Re: rewrite of TOC checkpoints.

Lynne Rosenthal suggested:
>Remove all: TOC checkpoints.
>In Guideline 13, add:

>Checkpoint:  Provide a way to find conformance information

>To fulfill this checkpoint, a specification MUST provide at least one
>navigation mechanism that allows the reader to locate all
>conformance-related information in the specification.

>Rationale: A reader must be able to easily identify and locate all the
>information necessary to understand the conformance policy and related
>conformance information without having to read the document from cover
>to cover.  Conformance information includes: the conformance section,
>conformance clause, and material about conformance variability.  A
>table of contents entry is one way to accomplish this.

I agree with Lofton that this could be stronger. There are specific
facets of conformance that we want to find without exhaustive search,
such as overall conformance policy, DoV used, even (wishfully) the
location of a test suite published by the WG. One way to develop the
set of facets to mention is by thinking about an implementer setting
out to implement the spec, and thinking about what they'll want to
know about conformance and testing.
.................David Marston

Received on Monday, 4 November 2002 10:35:10 UTC