QA WG Issues list

Good Practice: Use examples or use cases to illustrate

Open: 2004-08-25 Modified: 2004-08-25 Status: Open

Topic: Specification Guidelines Priority: Substantive  

Source : History of Changes Author: Karl Dubost Owner: Lynne Rosenthal

Description

Section B.1 Scope of the specification. This Good Practice has not been drafted yet.

Comment

A proposal by Lynne Rosenthal should be made before the next version of the specification which will be a Last Call. Expected Deadline: 2004-10-10

Proposal

Not done yet.

Resolution

No Resolution yet.

Example for ICS claim

Open: 2004-08-25 Modified: 2004-08-25 Status: Open

Topic: Specification Guidelines Priority: Substantive  

Source : History of Changes Author: Lynne Rosenthal Owner: Karl Dubost

Description

Add a good example of an ICS claim.

Comment

Lynne Rosenthal has proposed an example for ICS claim: WCAG 1.0.

Proposal

Karl Dubost to add the WCAG 1.0 example.

Resolution

B3 list of normative and non-normative references

Open: 2004-08-19 Modified: 2004-09-21 Status: Open

Topic: Specification Guidelines Priority: Substantive  

Source : [SpecGL Draft] B3 list of normative and non-normative references Author: Lynne Rosenthal, Björn Hörhmann Owner: Karl Dubost

Description

ISSUE: Björn Höhrmann has raised an important issue about the way normative references are given and their implications on the normativity of the specification itself. An short abstract of the issue can be foreseen as:

The QA WG is still discussing the issue. You are welcome to participate on the QA IG Mailing list (www-qa@w3.org publicly archived), but read first this two mail threads:

Comment

Lynne has proposed to remove it. Karl, Lofton, Dom think that we should modify the wording to rephrase it and capture the ideas of Björn.

Proposal

Karl Dubost to write a proposal on the mailing-list. Deadline: 2004-08-27

Resolution

What's a core module

Open: 2004-08-19 Modified: 2004-09-21 Status: Open

Topic: Specification Guidelines Priority: Substantive  

Source : [SpecGL] D1 Subdividing the spec. Author: David Marston Owner:

Description

David Marston makes a difference between usual modules and core module. Karl Dubost thinks it's just a specialization or naming not a functionnal difference.

Comment

Should it be a topic for Spec GL or Variability in Specifications?

Proposal

Resolution

Conformance section for a technology or for a specification

Open: 2004-08-19 Modified: 2004-09-21 Status: Open

Topic: Specification Guidelines Priority: Substantive  

Source : [SpecGL Draft] A.1 Principle: Include a conformance clause Author: David Marston Owner:

Description

From monolithic specification, WG are producing more and more multi-documents specifications. Each document being having its own life with dependencies with others. Though the division in many documents is not necessary a functionnal division (module, profile, level), but it could be a topic division. Let's imagine for example that the conformance section of a technology is one document. How to make clear where and when the conformance section or sections should go?

Comment

David Marston: "when a document is separate from another with which it was originally thought to be associated, it takes on a life of its own. "

Proposal

David Marston: 3. Each Recommendation addresses conformance. Those that don't specify behavior of a Class of Product may simply say that they are informative, but beware: even defining terms or stating principles can be normative if some other document could cite the terms or principles normatively. If your WG issues several Recommendations and some refer normatively to others in the set, try to isolate a Class of Product in each Rec and anticipate that other Recs may cite any individual Rec normatively.

Resolution

Label Normative and Informative section in QA Specification guidelines

Open: 2004-08-19 Modified: 2004-09-21 Status: Open

Topic: Specification Guidelines Priority: Editorial  

Source : [SpecGL Draft] Conformance Clause Author: Lynne Rosenthal Owner: Karl Dubost

Description

Do we label each section of the specification as normative or informative and at which level of details.

Comment

Proposal

Resolution

Terminology section and Conformance clause

Open: 2004-08-17 Modified: 2004-09-21 Status: Open

Topic: Specification Guidelines Priority: Substantive  

Source : [SpecGL Draft] A.1 GP In the conformance clause, define how normative language is expressed. Author: Lofton Henderson Owner: Karl Dubost

Description

In the remodeling of specification guidelines, one of the practice was recommending to put the normative language definition in the conformance section. Does the normative language should be defined under the conformance clause and only the conformance clause.

Good Practice: In the conformance clause, define how normative language is expressed.

It is not decided if it should be finally suppressed with a rewording of the another section or kept as it is.

Comment

Lofton Henderson: support the idea that it could stay where it is, as long as there is a link to it from the Conformance Clause.

Dominique Hazaël Massieux: mean how "conformance requirements are expressed"; I don't know what we would mean by "normative language", e.g. how does "normative language" relate to "normative content"

Proposal

Resolution

Techniques: Provide wording for the conformance claim

Open: 2004-08-18 Modified: 2004-09-21 Status: Open

Topic: Specification Guidelines Priority: Editorial  

Source : [SpecGL Draft] A.2 Provide the wording for conformance claims. Author: David Marston Owner: Karl Dubost

Description

David Marston has given a detailed list of techniques to for helping people to define conformance claim.

Comment

Karl: Do we want to go that far and that detailed?

Proposal

Resolution

Principle: Prevent extensions from breaking conformance

Open: 2004-08-25 Modified: 2004-09-21 Status: Open

Topic: Specification Guidelines Priority: Substantive  

Source : Specification Guidelines Author: Owner:

Description

ISSUE: Topic still in discussion by the WG

Extensions must not contradict or negate conformance to the specification. If it conformed without the extension, conformance should hold true with the extension. A coordination with the TAG and Web Architecture document has to be done.

Comment

Karl: The principle has to be written. A coordination with the TAG is in the process.

Proposal

Resolution

Editorial decisions from June F2F

Open: 2004-09-22 Modified: 2004-09-22 Status: Open

Topic: Specification Guidelines Priority: Editorial  

Source : [ISSUE] Integrate editorial decisions from June F2F Author: Dominique Hazaël-Massieux Owner: Karl Dubost

Description

Glancing quickly through the QA June F2F minutes and comparing it with the QA Specification Guidelines, it appears that most of the decisions we took wrt editorial comments for SpecGL haven't been implemented in the text yet; so, one of the issues that needs to be solved before going to last call is to actually implement them.

Comment

Dom has precised in an additional email the nature of the comments which have been forgotten. This mail includes:

  • Remove the RFC Keywords.
  • Meaningful and clear sentences for Good Practices and Principles.
  • Why Care of section A.1.

Proposal

Karl has proposed the following resolutions:

  • Todo: Remove the RFC Keywords.
  • Meaningful and clear sentences... See Issue 11
  • Editorial revision of all "Why Care". See Issue 12

Resolution

Meaningful sentences for Good Practices and Principles

Open: 2004-09-27 Modified: 2004-09-28 Status: Open

Topic: Specification Guidelines Priority: Editorial  

Source : [ISSUE] Clear GP/Principle statements Author: Dominique Hazaël-Massieux Owner: Karl Dubost

Description

Karl has made a list of all statements, they have to be reviewed for their clarity. Look at the thread.

Comment

Proposal

Karl has proposed the following resolutions:

  • Todo: Integrate the modifications when the list has been accepted.

Resolution

Revision of Why Care

Open: 2004-09-27 Modified: 2004-09-28 Status: Open

Topic: Specification Guidelines Priority: Editorial  

Source : Revise all "Why Care" Author: Karl Dubost Owner:

Description

The "Why Care" may sometimes not completely address the benefits of the Good Practice and the principle, they are explaining.

Comment

Proposal

It is needed to revise all "Why Care" using the following template.

When your review "Why Care?", think about the benefits for:

  • the technology
  • the spec author
  • the end users of products
  • the implementers

Resolution

Inconsistencies in Techniques Numbering

Open: 2004-10-03 Modified: 2004-10-03 Status: Open

Topic: Specification Guidelines Priority: Editorial  

Source : SpecGL - techniques Author: Lynne Rosenthal Owner: Karl Dubost

Description

The Techniques are numbered. Sometimes it seems that there is 1 techniques with multiple steps. Other times, there are multiple techniques (1 step each). We need to devise a better numbering scheme. Perhaps:

Resolution

Karl will fix in the next Editors Draft of Spec GL (Member Only)