- From: Karl Dubost <karl@w3.org>
- Date: Mon, 13 Mar 2006 14:11:56 +0900
- To: www-qa@w3.org
- Cc: Dominique Hazaël-Massieux <dom@w3.org>
Dominique, and QA IG,
(spec prod)
Le 06-03-08 à 14:26, Karl Dubost a écrit :
> W3C Glossary system
> http://www.w3.org/QA/2006/03/
> minutes_of_qa_ig_f2f_at_the_w3.html#w3c-glossary
>
> A new intern will
> start to work on this project in May 2006. The goals are
> translations of W3C Terms in different languages. This is useful
> for
> volunteers who translate W3C specifications.
I was looking for "test assertion" in the W3C Glossary and I found 3
references.
http://www.w3.org/2003/glossary/keyword/All/?keywords=test%20assertion
* First definition comes from "Specification Guidelines" version
2003-05-16
"A set of premises that are known to be true by definition in the spec."
* Second from the final version of the document
"A measurable or testable statement of behavior, action, or
condition. It is derived from the specification's requirements."
Suggestion:
- When a definition is available in a last version of a document
just display this one or put them in a thread ordered by date from
most recent to oldest.
* test assertion
"Last definition" - date
- previous def 1
- previous def 2
Another thing I have noticed that will not be solvable for legacy
documents, but could be improved for future one is to encourage the
use of "id" for definitions.
> The use of the W3C Glossary is encouraged on [39]W3C Editors home
> page.
> [39] http://www.w3.org/2003/Editors/
Maybe it could be encouraged in manual of style, to use a unique id.
So it's possible to point to the definition from outside and that W3C
Glossary provides a link to this id.
Dom,
I haven't found a page where it is explained for editors how to
create the right markup for their document.
http://www.w3.org/2003/03/glossary-project/analysis#datamodel
This is the only information I have found about it. Maybe you
would volunteer to write a Weblog entry giving the markup and
explaining simply without too many details how the system is working.
--
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 Monday, 13 March 2006 05:12:01 UTC