- 2003-09-12, intermediate WD
This version integrated the resolutions of the issues raised during the Last Call review; the document has been reordered and some of the guidelines have been consolidated; furthermore, many checkpoints have been reworded for sake of clarification or adjustment.
- a new "Concepts" section (section 2) gathers the most important concepts used throughout the document
- Former GL 4,5 and 6 have been consolidated into GL 3; during the operation, former CP 4.3, 5.2 and 6.1 have been merged, and most of the verbiage of those GL have been merged in the section 2.3
- Former GL 3 and 10 have been merged into GL 8
- Former GL 11 and 12 have been merged into GL 9
- GL 13 have been moved up as GL 7
- Test assertions derived from the specification are now available
- CP 9.1 and 9.2 have been merged
- The conformance section has been completed
- Rationales have been added to some CP
The detailed changes are more visible in the editor's version of SpecGL.
- 2003-02-10, Last Call WD
This version integrates the resolutions taken by the WG on the
issues raised since the last Working Draft; a good set of them have
been taken during the QA WG F2F in
Seattle. The structure hasn't really changed since the last draft,
except that some checkpoints were removed, some were added.
- the scope part of the introduction has been reworded for
clarification
- added an explicit section on normative sections
- created a list of checkpoints ordered by priority, that is used
as the ICS for the specification
- the conformance requirements are now explicitly labeled as
such
- the following CP have been removed (using numbers of the previous
version): CP 1.4
- the following CP have been added (using numbers of this version):
CP 2.4, 3.2, 3.3, 3.5, 7.3, 8.5, 9.7
- the following sections have been significantly modified: GL 3
verbiage, GL 13 verbiage, CP 1.1, 1.2, 8.3, 8.4, 9.4
- 2002-11-08, third published WD
While keeping most of the principles behind the second published
WD, this version has re-ordered the guidelines in a more logical way,
and takes a more formal approach in the design of CP, where all CP has
a set of test assertions. Besides, repetitions have been diminished
through factorization, and non-testable or arguable CP have been
removed or marked as to be moved as examples and techniques. Finally,
it integrates all the issues resolutions agreed during the QA WG Tokyo
face-to-face meeting and the weeks following.
- the introduction integrates explicit scope and goals as required
by the GL and has been cleaned of its repetitions
- usage of RFC 2119 has been clarified with the usage of uppercase
keywords
- the dimensions of variability have now their own section in the
introduction, regrouping the various bits previously scattered
around
- ex-GL 14 on granular grammars has been removed, some of its
content being integrated in the GL on test assertions
- ex-GL 6 on conformance policy has been moved ahead on GL 3, ex-GL
7 on levels has been grouped with its related GL on profiles and
modules
- every CP has now a set of test assertions using RFC 2119
keywords; most of them have an explicit rationale and some of them
an example; the style sheet has been modified to highlight the test
assertions
- the following CP (using numbering of the previous version) have
been removed: 1.4 (
Ensure that every test assertion is covered
by an example
), 2.3 (For each class of product, indicate
minimal support requirements.
), 3.1 (Choose whether or not
to have profiles.
), 3.2 (Include a table of contents
entry.
), 4.1 (Choose whether or not to have modules.
),
4.2 (Include a table of contents entry.
), 6.5 (Include a
table of contents entry.
), 7.1 (Address whether the
specification uses or will use functional levels.
), 7.2
(Include a table of contents entry.
), 9.7 (Include a
table of contents entry.
), 10.3 (Include a conformance
clause entry in the table of contents
), 10.5 (Identify all
dimensions of variability that are not used.
) 11.5 (Include
a table of contents entry.
), 13.3 (Follow Web Accessibility
Initiative and Internationalization Guidelines.
)
- CP 13.4 (
Provide a fast way to find conformance
information
) is new
- overall, an effort has been put into using a consistent
terminology across the specification and avoiding unclear or
untestable statement
- the verbiage on each DoV has been vastly reduced or factorized in
the DoV discussion in the introduction
- 2002-08-26, second published WD
-
Significantly reorganized and revised the first published WD. This
version produced as a series of editor's drafts. The changes below are
reverse chronological (most recent first), so more recent ones may
build on older ones.
- Handle negative disclaimers for DoV's via new
CK10.5.
- First cut at distinguishing specifications from technologies that
they describe (esp in profiles, modules, levels.)
- Add concept of SpecGL test assertions to "Conformance"
chapter.
- Define "use case" and "user scenario", revise GL1 & CK1.2 to
use them accordingly, clarify CK1.3 (Provide examples), add
rigorous CK1.4 (examples--TAs).
- Clean up "atomicity of modules" discussion, add atomicity to
CK4.3
- Harmonize priorities of CK8.1 & 8.2, 9.1 & 9.2.
- All GL14 and GL15 checkpoints to priority 2, except CK15.1;
tighten descriptions.
- All TOC checkpoints
to priority 2, except Conformance Clause (p1).
- Accommodate "Rules for Profiles" in GL2 categories and classes;
new CK3.6 and changes to 2.3.
- Add caveat to "Understanding and using.." (sec. 1.2), about
specifications that pre-date SpecGL.
- Rewrite CK11.1 to replace 'levels' in "conformance levels" w/
degrees, categories, etc (confusion with "functional levels").
- Change "levels" to "degrees" in SpecGL conformance clause.
- Change "discretionary behaviors" to "discretionary items" in GL8,
define three variants in GL8 verbiage.
- Extensive new prose in GL3 (profiles), GL4 (modules), GL7
(levels), describing potential relationships.
- Fixed definition of strict conformance, clarified definition and
usage of "conformance clause".
- Added "Definitions" section (in-spec glossary).
- Enhanced wording of all TOC checkpoints.
- For each of CK3.x (profiles), 4.x (modules), 7.x (levels),
x>1, added a "not applicable" disclaimer if the feature is not
used. (Except for the TOC checkpoints.)
- Change wording of CK7.x, eliminating "chosen", and add some new
explanation to 7.1
- Delete CK5.4 (conformance policy in conformance clause) and move
its verbiage to GL10 (conformance clause) and its checkpoints.
- Fix "Conformance" chapter, add "Checkpoint Priorities"
section.
- Change chapter title of "Navigating through this document" to
"Understanding and using this document"
- New text for Checkpoint 3.4
- Added warnings about "excessive variability" to all
dimension-of-variability guidelines.
- Added to several DoV checkpoints a
requirement to explain/justify any variability dimension by use
cases and requirements.
- Fix separation between last two guidelines, "Granular Grammars"
and "Test Assertions".
- Introduce and motivate "dimensions of variability" (DoV) in sec
1.5
- Reordered guidelines (GL), split GL.5 into three new ones, GL.3,
GL.4, and GL.7, customized checkpoints to their topics (profiles,
modules, levels).
- Added new p3 checkpoint ("categorize specification") to (new)
GL.2
- Rewrote (old) GL.3, "conformance flavors", in terms of "specify
conformance policy, (new) GL.5.
- Split CK1.3 into two, wrote new rationale and removed CK1.4.
- Replaced CK9.1 and 9.2 with proposed wording from Issue 106.
- Modified CK13.4, adding 'direct access' and a reference to DoV
checkpoints.
- Deleted CK10.1 and changed priority of CK10.2.
- Added new section on extensibility of SpecGL in the Conformance
section.
- 2002-05-15 version
-
First published WD.