- From: Karl Dubost <karl@w3.org>
- Date: Tue, 12 Sep 2006 17:20:29 +0900
- To: Shane McCarron <voyager-issues@mn.aptest.com>
- Cc: www-html-editor@w3.org
Le 12 sept. 06 à 16:53, Shane McCarron a écrit : > 1) While we appreciate that what you suggest might make reading > easier, the way > we do it is how W3C specs all do it as far as we know. We do agree > about > expanding the text, and will attempt to make that change over time. No, All specifications don't do it like that. An example http://www.w3.org/TR/qaframe-spec/#about And using a correct citation scheme is also recommended in the W3C Manual of Style 7.2 Citation http://www.w3.org/2001/06/manual/#citation > 2) We agree that semantic markup is a good thing. We do not have a > convention > for annotating specific document roles at this time. Thanks for > the comment. Will the WG do for next version of the publication? > 3) You suggest that we remove things that will not be relevant > after a few > years. We agree. If there are specific items, please let us know > what they > are. 1. Introduction http://www.w3.org/TR/2006/WD-xhtml-role-20060725/#s_intro an example of what we call a factual fact. [[[ Note that this work was originally done as part of the [XHTML2] activity. It is being released in a separate, stand-alone module in order to speed its adoption and ease the migration to XHTML 2 when that is released. ]]] > 4) We will make a note somewhere that all examples are non-normative. That will half solved the issue. How one's know that the prose is an example or not in the text. The problem is that the prose often mixed a requirement and an example in the same paragraph. Please do separate examples from normative prose explicitly. > 5) Agreed. a grep should on the next version of the document should help to catch the case issue. And also help to add an appropriate markup See for example 10. RFC 2119 Key Words http://www.w3.org/2001/06/manual/#RFC > 6) Thanks. We will fix. Thanks -- 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 Tuesday, 12 September 2006 08:21:35 UTC