- From: olivier Thereaux <ot@w3.org>
- Date: Wed, 24 Aug 2005 11:52:07 +0900
- 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 UTC