[Bug 6376] [Ser] non-normative notes

http://www.w3.org/Bugs/Public/show_bug.cgi?id=6376





--- Comment #1 from Henry Zongaro <zongaro@ca.ibm.com>  2009-01-06 21:55:41 ---
It looks like the Serialization recommendation is inconsistent about its
presentation of examples.  In most cases they are not marked as "Notes."  They
are usually contained in boxes - see [1], which at least begins "For example,"
or [2], which just asks us to "Consider...."

But some examples are just contained within the normative prose without
anything to set them apart typographically - see the "media-type" parameter in
[3] or the second paragraph following the table in [3].

Obviously this should all be cleaned up for 1.1, but I doubt we'd want to issue
a 1.0 erratum.  Should it be cleaned up for the 1.0 2nd edition though?

[1]
http://www.w3.org/TR/2007/REC-xslt-xquery-serialization-20070123/#XML_VERSION
[2]
http://www.w3.org/TR/2007/REC-xslt-xquery-serialization-20070123/#xml-undeclare-NS
[3] http://www.w3.org/TR/2007/REC-xslt-xquery-serialization-20070123/#serparam


-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.

Received on Tuesday, 6 January 2009 21:55:49 UTC