W3C home > Mailing lists > Public > www-webont-wg@w3.org > December 2003

Re: QAF Ops Guidelines review action [LONG]

From: Jeremy Carroll <jjc@hpl.hp.com>
Date: Wed, 17 Dec 2003 14:49:21 +0100
To: www-webont-wg@w3.org
Message-Id: <200312171449.21907.jjc@hpl.hp.com>


jeremy and evan:
>> Doing that a hundred times over would have made the document unreadable, 

sandro:
> unionOf is only one of many parts
> of OWL
 what I was getting at is that much of the normative content of S&AS is 
expressed in the terse mathematical way in which unionOf is defined - for 
every row of every table we should do the same, if we were to follow in 
detail the Specification guidelines (which we were not specifically 
reviewing, but it is hard to review a compound spec in parts). (It is unclear 
how one would address the mapping rules and the abstract syntax rules)

So the specific checkpoint I had in mind was:

http://www.w3.org/TR/2003/CR-qaframe-spec-20031110/guidelines-chapter#Gd-include-assertions
"The specification MUST provide a normative list of test assertions. "

The discussion of this is weak, in particular the link trail from the CR 
document peters out with an under construction before one finds actual 
examples of what this is intended to mean. 
http://www.w3.org/QA/WG/2003/09/qaframe-spec-extech-20030912#Ck-include-assertions

I understand that they mean "Tests can point directly to the test assertion," 
i.e. every atomic test should have a testable assertion that it corresponds 
to, and that ideally this testable assertion should use RFC 2119 language.

I am pretty clear that there are more than 100 atomic tests concerning the 
maths in S&AS and so the "hundred" is probably not an exageration.

There are 238 "<tr" in S&AS, I believe most would need attention.
(I note that many have anchors which is a recent? improvement from the point 
of view of being able to refer to them)

===

The links petering out suggests that a different quality goal is that 
multi-document recommendations should be published as a whole at each 
maturity level - don't they have that already:

http://www.w3.org/TR/qaframe-ops/guidelines-chapter#Gd-sync-spec-TM-devt
[[
Checkpoint 3.1. Synchronize the publication of QA deliverables and the 
specification's drafts. [Priority 2]
]]

they may have played by the letter of this, but certainly not by the spirit 
with links off to unfinished work.

Jeremy
Received on Wednesday, 17 December 2003 08:50:01 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:58:03 GMT