W3C home > Mailing lists > Public > public-wai-ert@w3.org > January 2007

RFC 2119 keywords, prose, and Conformance Re: experience generating EARL for GRDDL test results

From: Karl Dubost <karl@w3.org>
Date: Tue, 16 Jan 2007 14:55:21 +0900
Message-Id: <A59526AE-3E2E-4A93-95E9-0C323E3C8139@w3.org>
Cc: Shadi Abou-Zahra <shadi@w3.org>, public-grddl-comments@w3.org, Sean Palmer <sean@miscoranda.com>, public-wai-ert@w3.org, www-qa@w3.org, public-sparql-dev@w3.org
To: Dan Connolly <connolly@w3.org>

Hi,
(feel free to drop names and lists if you think the audience is too  
wide)

RFC 2119 and Conformance is a whole another topic… which has created  
discussions in the belated QA WG.

Le 16 janv. 2007 à 03:49, Dan Connolly a écrit :
> Looking at [1], I see
>   "An Assertion must have at least the following properties"
> that's odd too.
>
> [[
> I think it's a misuse of RFC2119 to say things like "2 + 2 MUST be  
> 4" or "every attribute value in an XML document MUST be quoted."  
> Better to just say "2 + 2 is 4" and "every attribute value in an  
> XML document is quoted."
> ]]
>  -- "must is for agents", Dan Connolly, Jan 2001
>  http://www.w3.org/2001/01/mp23

See also
http://esw.w3.org/topic/RfcKeywords

With Danc's proposal here, let's state that we only use "RFC 2119"  
for agents. There is then a need sometimes to define in a  
specification what is an assertion and what is simple prose. The only  
way to do that is, either, having

     - separate list of testable assertion
       http://www.w3.org/TR/qaframe-spec/#write-assertion-gp
       http://www.w3.org/TR/qaframe-spec/#consistent-style-principle
     - a specific markup in the specification to identify what is prose

QA Specification Guidelines says:
http://www.w3.org/TR/qaframe-spec/#norm-informative-gp

     "Specify in the conformance clause how to distinguish
      normative from informative content."

with the associated technique

     "3. Try to avoid language that sounds normative in an
      informative section. It might lead the readers to wrong
      assumptions."

But sometimes it is not that easy. Forbidding the use of RFC 2119  
keywords is odd too, there are just English terms.


Question:
    - Does the term "agents" include humans?



-- 
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, 16 January 2007 05:56:02 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:18:27 GMT