conformance — archive
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
— [Date Index]
| [Thread Index]
| [Month Index]
| [List Home]
RE: new version of Conformance Requirements Document
Thank you for the comments. In addition to addressing comments as they come in, I will also create a log to keep track of the comments and their disposition. Please note that the disposition of a comment isn't final until all have reviewed and accepted/rejected the comment - which will occur either via email or at a meeting (teleconf or f2f).
At 02:05 PM 8/22/01 -0400, David Smiley wrote:
A few comments on the new version of the doc/spec. Most of these are formatting and consistency issues (conformance?), but the first regards content and meaning.
----------------------------------------------------------------------------
----------------
Section 7.5 Alternate Approaches
282 Specifications may describe several different ways to accomplish its operation (e.g., a
283 choice of file formats, protocols, or codes). In such a case, the conformance clause
284 should specify under what conditions an implementation is considered to be conformant. 285 Some possible ways to define conformance include mandating that an implementation
286 shall:
Line 284, do we mean "should" or "shall"?
Good catch - it shall be changed to SHALL
----------------------------------------------------------------------------
----------------
Section 7.3.3. Mechanism to allow extensions
257 For example, the ISO Computer Graphics Metafile (CGM) standard on which the W3C 258 WebCGM Recommendation is based provides for both a standard function (GDP 259 element) for defining private graphics functionality as well as using negative values to
260 define private values. Thus by invoking the GDP element a user (CGM 261 generator) can define a new graphical function.
Line 258 - Delete the word "for".
Line 259 - Change "as well as using" to "as well as the use of". Also, this is a very long sentence just begging to be split
into 2 sentences, or punctuated with additional commas.
Suggestion: For example, the ISO Computer Graphics Metafile (CGM) is the standard on which the W3C WebCGM Recommendation is based. It provides both a standard function (GDP element) for defining private graphics functionality, as well as the use of negative values to define private values.
Agreed. Thanks for the rewrite
----------------------------------------------------------------------------
----------------
Reference Documents Terms and Conditions Rationale for a conformance clause etc.
In these bulleted lists, there is inconsistency in the punctuation at the end of each item. Sometimes there is none, other times there are commas, periods or semicolons.
----------------------------------------------------------------------------
----------------
Line 213
Change "etc" (no period) to "etc.".
----------------------------------------------------------------------------
----------------
Line 292
Change "if" (no capital) to "If".
----------------------------------------------------------------------------
----------------
Agreed. Done.
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
— [Date Index]
| [Thread Index]
| [Month Index]
| [List Home]