W3C home > Mailing lists > Public > www-qa-wg@w3.org > August 2004

[SpecGL Draft] B2 What needs to conform

From: Lynne Rosenthal <lynne.rosenthal@nist.gov>
Date: Thu, 19 Aug 2004 15:40:48 -0400
Message-Id: <6.0.0.22.2.20040819153924.01c4e698@wsxg03.nist.gov>
To: www-qa-wg@w3.org, "Karl Dubost" <karl@w3.org>

I don't have much for to say under Technique or Examples.

--------------------------------
What needs to conform?

Principle: Identify who or what will implement the specification

What does this mean?
Clearly identify the class of products (i.e., type of products or services) 
to which the specification applies.  If multiple classes of products are 
targeted by the specification, make sure each are described.   Examples of 
classes of products include: content, producer of content, player, 
protocol, API, agent, guidelines.

Why care?
It helps define the scope of the specification.  It also helps the reader 
know what is being targeted by the specification – that is, to discover and 
focus on what they have turned to the document for and avoid what they may 
find immaterial.

Techniques.
List and describe the classes of products that will implement the 
specification.

Examples;

QA Framework: Specification Guidelines defines one class of product – 
specifications

MathML identifies a class of product, called MathML processors.  Included 
in this class of product are: editors for authoring MathML expressions, 
translators for converting to and from other encodings, validators for 
checking MathML expressions, computation engines and rendering engines
Received on Thursday, 19 August 2004 19:40:53 GMT

This archive was generated by hypermail 2.2.0 + w3c-0.30 : Thursday, 9 June 2005 12:13:18 GMT