W3C home > Mailing lists > Public > www-html-editor@w3.org > July to September 2006

[xhtml-role] Document Conformance and testable assertions.

From: <karl@w3.org>
Date: Thu, 10 Aug 2006 07:37:58 -0000
To: www-html-editor@w3.org
Message-Id: <20060810073818.A4B804F35B@homer.w3.org>

This is a QA Review comment for "XHTML Role Attribute Module"
1st WD

About http://www.w3.org/TR/2006/WD-xhtml-role-20060725/#docconf

We have extracted the sentences with MUST. It seems that some requirements are escaping or not really well defined. Please review every statements defining requirements and be sure that they can be easily self-consistent whenever it's possible. 
The specification is far to be clear when sentences (assertions) are extracted from their context. Either create sentences being self testable or create a markup to extract testable assertions.

List of sentences with MUST

* Such a document MUST meet all the following criteria:
* The document MUST conform to the constraints expressed in Appendix A - DTD Implementation, combined with the constraints expressed in its host language implementation.
* If the host language does not incorporate the XHTML Role Attribute Module attribute into its own namespace, the document MUST contain an xmlns declaration for the XHTML Role Attribute Module namespace [XMLNAMES].
* When the XHTML Role Attribute Module is included in a host language, all of the facilities required in this specification MUST be included in the host language.
* In addition, the attribute defined in this specification MUST be included in the content model of the host language.
* A conforming user agent MUST support all of the features required in this specification.
* Such values MUST be defined in their own namespace.

no sentences with SHOULD, MAY, etc.

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, 10 August 2006 07:38:38 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 15:08:55 UTC