W3C home > Mailing lists > Public > public-cdf@w3.org > August 2005

[WICD-oT-5] WICD review - normative versus informative

From: olivier Thereaux <ot@w3.org>
Date: Wed, 24 Aug 2005 11:52:07 +0900
Message-Id: <435CB9A5-FE11-413E-955E-CFFB7FCCFA06@w3.org>
To: public-cdf@w3.org

Dear CDF working group.

This is a comment on the W3C Working Draft Dated 09 August 2005 of  
"Compound Document Framework 1.0 and WICD Profiles"
http://www.w3.org/TR/2005/WD-WICD-20050809/


Marking of non-normative content is already good in this first  
working draft, but could still be improved.

The existing conformance section of the document has a clear section  
on RFC2119 keywords, which is good. It could, however, give a summary  
or explanation of how sections are normative, or not.

Within the specification text itself, whether a section is normative  
or not could be made clearer and more consistent. Notably, non- 
normative section are sometimes marked as "non normative", sometimes  
"informative". Informative sections are properly marked, but it could  
be useful to distinguish them entirely (through styling or a mark at  
the end of informative sections), not just at the beginning.

The assumption that all sections not marked as "informative" are  
normative is fair, but could be clarified in the conformance section.

See also:
http://www.w3.org/TR/qaframe-spec/#norm-informative-gp

This comment is related to:
[WICD-oT-4] WICD review - conformance section

Regards,
-- 
olivier
Received on Wednesday, 24 August 2005 02:52:13 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:10:40 GMT