W3C home > Mailing lists > Public > www-style@w3.org > September 2006

[css3-namespace] Syntax requirements clarity and Testable assertions

From: <karl@w3.org>
Date: Tue, 05 Sep 2006 05:56:40 -0000
To: www-style@w3.org
Message-Id: <20060905055706.CD3A34F46A@homer.w3.org>

Hi,
This is a QA Review comment for "CSS Module: Namespaces"
http://www.w3.org/TR/2006/WD-css3-namespace-20060828/
2006-08-28
2nd WD

About http://www.w3.org/TR/2006/WD-css3-namespace-20060828/#syntax

Sometimes, too many requirements in one sentence make it difficult to understand, the sentence.

	[[[
	Any @namespace rules must follow all @charset 
	and @import rules and precede all other non-ignored 
	at-rules and rule sets in a style sheet. 
	]]]

This seems to break down to:

	Any @namespace rules MUST follow all @charset rules.
	Any @namespace rules MUST follow all @import rules.
	Any @namespace rules MUST precede all other non-ignored at-rules.
	Any @namespace rules MUST precede all rule sets.

Test cases would be helpful for a clear understanding. Be sure that all the sentences in the document can be expressed or transcribed as testable requirements. When the WG is creating a test case for each requirements, give a link to the test case from the WD. It will help implementers and reviewers to understand the requirements and it will help the WGs to write clear sentences.




-- 
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, 5 September 2006 05:57:22 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 27 April 2009 13:54:46 GMT