W3C home > Mailing lists > Public > www-svg@w3.org > May 2005

[SVGMobile12] Normative and informative sections

From: Boris Zbarsky <bzbarsky@mit.edu>
Date: Tue, 17 May 2005 16:02:30 -0500
Message-ID: <428A5BE6.2050102@mit.edu>
To: www-svg@w3.org

I'm finding it very difficult to review (and would find even more difficult to 
implement) this specification, because the normative and informative sections 
are not clearly marked as such and because the normative and informative 
information is often intermingled in the same section and sometimes in a single 
paragraph.

Please clearly label the normative and informative sections accordingly.  This 
will help implementors enormously, since they won't have to read every single 
word of what looks like informative text to check whether it happens to contain 
conformance requirements.  I would recommend fully giving the normative 
definition of an element first, then giving informative examples illustrating 
the use of the element and its various attributes, with links from the normative 
section to the informative one as needed.

-Boris
Received on Tuesday, 17 May 2005 21:05:33 GMT

This archive was generated by hypermail 2.3.1 : Friday, 8 March 2013 15:54:30 GMT