W3C home > Mailing lists > Public > www-qa@w3.org > March 2003

LC comment for SpecGL : 'Self-sufficient guidelines and checkpoints'

From: by way of the Lastcall Form <jmarsh@microsoft.com>
Date: Tue, 1 Apr 2003 03:29 +0900
To: www-qa@w3.org
Message-Id: <20030331182944.F25C71542@toro.w3.mag.keio.ac.jp>

Here is a last call comment from Jonathan Marsh (jmarsh@microsoft.com) 
on QA Framework : Specifications Guidelines (and Examples and Techniques)
received by the LC form system.

Submitted on behalf of: WS Description WG
Comment type: Editorial
The comment applies to: "Overall"
Comment title: Self-sufficient guidelines and checkpoints

In general, the language is insufficiently rigorous/precise for a common use case, and the model may be explained in text rather than structurally.  The problem is that, while many WG members may read the entire spec, others may be tasked with judging conformance to a particular guideline, or even a particular checkpoint.  

Proposed resolution : 
Insofar as is possible guidelines and checkpoints should contain sufficient definition for local understanding, and pointers to all related items in the document.  That is, a reader should be able to enter via any checkpoint, and gather all and only the information needed to understand the checkpoint starting from that entry point.


This comment was submitted through the lastCall form system,
designed by Martin Duerst and Adapted for the QAWG by Olivier Thereaux.
Received on Monday, 31 March 2003 13:29:46 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:40:31 UTC