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

[SpecGL Draft] A.1 GP Define the specification conformance model in the conformance clause.

From: Karl Dubost <karl@w3.org>
Date: Tue, 3 Aug 2004 16:21:51 -0400
Message-Id: <C13BF7E1-E58A-11D8-91B3-000A95718F82@w3.org>
To: www-qa-wg@w3.org
Good Practice:
	Define the specification conformance model in the conformance clause.

What does it mean?
	The conformance model is the conceptual framework in which conformance 
is defined. It consists of and is defined by addressing at least these 
three topics:

	What may conform and how ("Class of Product", see @@section B.2@@)
	Any special designations or concepts used to distinguish
         separate  conformance categories (e.g., profile, modules,
         see @@section D.1@@)
	Ways that conforming implementations can vary from each
         other (e.g.,  optionality, extensions, etc, see @@sections
         X.# and Y.#@@)

Why should I Care?
	By defining the conformance model, developers will be able to 
articulate the different sections of the technology with regards to 
their implementations. It will be easier for them to focus on the 
relevant parts of the technology and therefore it will be faster to 
develop a good quality implementation.

Related:
The conformance model overlaps several other topics in SpecGL, most 
particularly:
	 	@@CoP, section B.2@@
	 	section D.1
	 	section X.#
	 	section Y.#
	 	advanced topic @@"Dimensions of Variability"@@
	 	...etc...

Techniques:

	1. List all dimensions of variability
		a. List the different classes of Products.
		b. List, if any, the different profiles, modules and levels.
		c. List the options and extensions.
	2. Draw a diagram showing the relationship between these dimensions of 
variability
	3. Rationalize this drawing by defining your conformance model
	4. Write it down in your specification as clearly as possible.
	5. Bonus: If the diagram helps to understand, add it.

(@@The techniques clearly show that the more there is dimension of 
variability, the more it's difficult to define a conformance model@@)


Example:
	@@Is there a place with a conformance model explained@@
	@@What's the conformance model of SpecGL? A volunteer?@@



-- 
Karl Dubost - http://www.w3.org/People/karl/
W3C Conformance Manager
*** Be Strict To Be Cool ***

Received on Tuesday, 3 August 2004 16:21:57 GMT

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