W3C home > Mailing lists > Public > www-qa-wg@w3.org > May 2005

draft proposed rewording of Scope (for Al comment)

From: Lofton Henderson <lofton@rockynet.com>
Date: Fri, 27 May 2005 10:02:48 -0600
Message-Id: <5.1.0.14.2.20050527094613.0225f1e8@rockynet.com>
To: www-qa-wg@w3.org
QAWG,

Here is a new proposed draft for SpecGL Scope section [1].  I conjoined the 
stuff in 1st paragraph with the stuff in the 3rd, to make a new 1st 
paragraph.  In the process, I got rid of the word "better".  I didn't touch 
the other two paragraphs -- formerly 2nd and 4th, now 2nd and 3rd.  I think 
it could still flow better and be improved -- it currently uses all of the 
bits and pieces that we had before -- but here is a first cut...

[[[
This document is a guide for W3C specification editors and authors. It 
provides guidelines for improving the conformance related characteristics 
of specifications.  In that respect, this document differs from other W3C 
process and publication related documents. It addresses the most basic and 
critical topics with respect to conformance, including how to convey what 
is required for an implementation in order to conform and how to allow 
variation among conforming implementations.

The term specification is used as defined in ISO Guide 2-4 [ISO-GUIDE] as 
meaning a document that prescribes requirements to be fulfilled by a 
product, process or service. Specifications can be defined in one document 
or as a coherent set of several documents (see Umbrella specifications in 
Variability in Specifications [VIS] for more discussion), and can import 
requirements of other specifications with normative references.

In addition to conformance, there are several other topics that should be 
addressed when writing a specification, such as accessibility, 
internationalization, security, and device independence. These topics are 
not directly in the scope of this document, but are evoked in section 3.3. 
Specification authors and editors are encouraged to consider these topics 
and coordinate their efforts in these areas with the relevant W3C Working 
Groups.
]]]

Regards,
-Lofton.

[1] http://www.w3.org/TR/2005/WD-qaframe-spec-20050428/#scope-goals
Received on Friday, 27 May 2005 16:02:54 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:14:35 UTC