[XBL] XBL 2.0 Conformance requirements and examples

Hi,
This is a QA Review comment for "XML Binding Language (XBL) 2.0"
http://www.w3.org/TR/2006/WD-xbl-20060907/
2006-06-19
Last Call WD

About http://www.w3.org/TR/2006/WD-xbl-20060907/#conformance

It is always good to avoid to mix conformance requirements with examples in the prose. At least, it is better to make a clear distinction. The conformance section says it clearly but nonetheless create individual paragraph for example. not like in

[[[
This specification is defined in terms of the DOM. The language in this specification assumes that the user agent expands all entity references, and therefore not include entity reference nodes in the DOM. If user agents do include entity reference nodes in the DOM, then user agents must handle them as if they were fully expanded when implementing this specification. For example, if a requirement talks about an element's child text nodes, then any text nodes that are children of an entity reference that is a child of that element must be used as well.
]]] -- XML Binding Language (XBL) 2.0
       http://www.w3.org/TR/2006/WD-xbl-20060619/#conformance
       Tue, 20 Jun 2006 15:27:58 GMT




-- 
Karl Dubost - http://www.w3.org/People/karl/
W3C Conformance Manager, QA Activity Lead
   QA Weblog - http://www.w3.org/QA/
      *** Be Strict To Be Cool ***

Received on Thursday, 5 October 2006 05:45:33 UTC