- From: Lynne Rosenthal <lynne.rosenthal@nist.gov>
- Date: Sun, 06 Apr 2003 20:12:57 -0400
- To: www-qa-wg@w3.org
- Message-Id: <5.1.0.14.2.20030406200535.00aa42b8@mailserver.nist.gov>
For discussion: Last Call issues SpecGL. The issue, discussion and alternatives are provided for a few of the related issue groups identified by Lofton (http://lists.w3.org/Archives/Public/www-qa-wg/2003Apr/0020.html ) 1. EXAMPLES, USE CSES, etc 23: usefulness of CP1.4 75.1: reorder CP 1.3 and 1.4 (increasing priority) 92: difference between CP1.2 and CP1.4 79: fail CP 1.2 and 1.3 77.ET2: LC-23: Usefulness of CP 1.4 (from Dom) > - LC-23 has a specific proposal to break down the requirements per >type of specifications [meta-issue: are the categories defined in [2] >classes of product for specGL?] > Discussion: The proposal is interesting; since our classifications of >spec is probably not exhaustive, we would need to find a mechanism >that would allow to deal with non-identified categories (hmm... specGL >extensions ?) This CP has been rewritten several times, from a more specific requirement to this one. Alternatives: 1. Implement the proposal make more specific requirements and tie it to specification categories. 2. Implement the proposal in the ExTech document, but leave CP as is 3. Implement the proposal in the ExTech document, and make CP more specific without mentioning categories. (I'm not sure how we do this) Recommend #2 but if someone can make the CP more explicit great. LC-75.1: reorder CP 1.3 and 1.4, so listed in priority order Discussion: CP 1.3 (P3) address a broader scope than CP1.4 (P2). Thus, the CPs of Guideline 1 go from broad (the spec as a whole) to more narrow aspects (each behavior or functions) Alternatives 1. Reverse CP 1.3 and 1.4 2. Leave as is LC 92: Difference between CP 1.2 and CP 1.4 Discussion: CP1.2 requires examples of what is in scope; CO 1.4 requires examples of specific functionality, concepts, behavior. Need to make this clearer, perhaps remove 'concepts' from CP 1.4 will help Alternatives: 1. Clarify the difference that 1.2 is broader examples, whereas 1.4 is very specific to a function or behavior. 2. Remove CP 1.4 3. Remove CP 1.2 LC-79: fails CP 1.2 and CP 1.3 no examples and usage scenarios given Discussion: examples are not given for what is in scope, nor are usage scenarios given. This was probably due to lack of resources (someone) to write these. Do we still believe that a spec should include these? Alternatives 1. Add examples and/or use cases, and provide usage scenarios 2. No need to, these are "not applicable" to SpecGL 3. No need to, SpecGl only needs to conform to itself at level "A Conforming" (only P1 checkpoints) Recommend: #1. We should do what we require other specs to do and conform at level AAA LC-77.ET-2 DEPRECATION: 33: Editorial: "used" may not be specific enough term. 40: add obsolete features 99: CP7.3 can't meet requirement due to reason for deprecation LC-40: Include discussion of obsolete features Discussion: Similar to deprecation, it is also important to identify the relation between obsolete features and provide alternatives to them. E.g., HTML 4.0 made obsolete a few elements. Alternatives: 1. Add a new Guideline to address obsolescence, with same checkpoints as Deprecation 2. Include obsolescence with deprecation add 1 or 2 checkpoint on obsolete features in the Guideline 3. Broaden the scope of deprecation to include obsolescence so each checkpoint applies to deprecated and obsolete features. LC-99 CP7.3 awkward requirement It is likely that some things are deprecated precisely because they cannot be well defined and unambiguously characterized. There may not be agreement on its relation and interaction with other DoV that may be why it is being deprecated. (catch 22?) Alternative: 1. Remove the CP 2. Add a rationale and techniques in ExTech WHAT IS NORMATIVE (editorial) LC- 36, 65, 106, 108 It is unclear which sections, paragraphs, and sentences are normative. Is the Glossary (sec 4 Definitions, or external Glossary) normative? Section 3.1, "following sections are normative" then identifies sentences, and paragraphs that are normative. RFC 2119 terms are not normative, but the use of the keywords indicates normative sentences. Priority levels are not normative. In Section 2, only the Conformance Requirements are normative, Section 3 is Normative, Is Section 1 Normative? Alternatives 1. change definition of Normative (dependent on someone supplying a new definition) 2. leave definition as is. 3. label all sections, as part of the section title and delete section 3.1 4. reword section 3.1 and label paragraphs, sections, etc that are normative. Recommend: #4and #1 CP 8.4 CONSISTENT HANDLING of DISCRETIONARY CHOICES LC-16, 39: What does this mean Discussion: comments regarding "document the identified policies". Needs to be clarified and if possible, made simpler. This CP has been rewritten several times. It seems to be a difficult concept to describe clearly and with broad application. Alternatives 1. try again, and rewrite (volunteers?) 2. delete the checkpoint 3. leave it as is. SECTION NUMBERING Editorial LC-63, 91 Better way to number Sections and guidelines/CP and list in Table of Contents. How does Accessibility Guidelines do this?
Received on Sunday, 6 April 2003 20:16:18 UTC