- From: Lynne Rosenthal <lynne.rosenthal@nist.gov>
- Date: Thu, 19 Aug 2004 10:29:37 -0400
- To: www-qa-wg@w3.org, "Karl Dubost" <karl@w3.org>
- Message-Id: <6.0.0.22.2.20040819102735.01d43f50@wsxg03.nist.gov>
Conformance
Conformance to the QA Framework: Specification Guidelines is very simple.
* It applies to one class of product – Working Group specifications
(i.e., technical reports).
* It is monolithic – no modules, levels or profiles are defined.
* It has only one conformance label, called ‘conformance’.
* It has options, but the options do not affect conformance.
* It allows extensions, but the extensions do not affect conformance.
The conformance requirements of this document are denoted as
Principles. All Principles are written in imperative voice, with the
assumed “you must’ in front of the statement. In addition to Principles,
the document contains Good Practices. Good Practices are optional and
considered recommendations. Their implementation or non-implementation
does not affect conformance to this Specification Guidelines document.
To conform to this Specification Guidelines, all Principles must be
implemented.
One way to satisfy the Principles and Good Practices is to implement one or
more of the suggested techniques given for each Principle and Good
Practice. Note that this is not the only way to satisfy the Principle or
Good Practice. An Implementation Conformance Statement is provided for
assistance in keeping track of which Principles and Good Practices are
implemented. It takes the form of a checklist. If all the Principles are
checked as being satisfied, then conformance can be claimed. [Karl – can
you extract the Principles and GPs to create a checklist, and make this an
Appendix?]
Normative parts
The normative parts of this specification are identified by markup and
style as well as the labels, ‘normative’ and ‘informative’ within
sections. [Karl- I’m assuming that we are labeling things, if not, remove
this part of the sentence]. The following list indicates the normativity
of parts in this specification.
Principles Normative
Good Practice Normative
What does this mean? Informative
Why Care? Informative
Techniques Informative [or is this normative?]
Examples Informative
Text that is designated as normative is directly applicable to achieving
conformance to this document. Informative parts of this document consist
of examples, extended explanations, and other matter that contains
information that should be understood for proper implementation of this
document.
Extensibility
This specification is extensible. That is, adding conformance related
information and structure to the document in ways beyond what is presented
as Principles in this specification, is allowed and encouraged. Extensions
to this specification must not contradict nor negate the requirements in
this specification.
Conformance claims
To claim conformance to the QA Framework: Specification Guidelines, Working
Groups must specify:
* guidelines title and dated URI: QA Framework: Specification
Guidelines, URI
* URI of a dated version of the specification for which conformance is
being claimed,
* date of the claim.
Example:
On 1 October 2004, W3C’s QA Handbook
(<http://www.w3.org/TR/2004/>http://www.w3.org/TR/2004/???) dated XX
September 2004 conforms to W3C’s QA Framework: Specification Guidelines,
available at
<http://www.w3.org/TR/2004/WD-qaframe-spec-2004????/>http://www.w3.org/TR/2004/WD-qaframe-spec-2004????/.
On 1 October 2004, W3C’s QA Framework: Specification Guidelines
(<http://www.w3.org/TR/2004/>http://www.w3.org/TR/2004/WD-qaframe-spec-2004????/)
dated XX September 2004 conforms to W3C’s QA Framework: Specification
Guidelines, available at
<http://www.w3.org/TR/2004/WD-qaframe-spec-2004????/>http://www.w3.org/TR/2004/WD-qaframe-spec-2004????/.
Received on Thursday, 19 August 2004 14:29:39 UTC