- From: Karl Dubost <karl@w3.org>
- Date: Tue, 16 May 2006 14:50:36 +0900
- To: public-swbp-wg@w3.org
Hi,
This is a QA Review comment for "RDF/A Primer 1.0"
http://www.w3.org/TR/2006/WD-xhtml-rdfa-primer-20060310/
Mon, 13 Mar 2006 20:37:46 GMT
1st WD
General comment:
The document is easy to read, specifically the first parts, but
sometimes we get a bit lost. If I understood the intent is to show a
user scenario. I don't know if it is a question of layout, but I
think it could be improved to really distinguish what is properly the
user scenario and what is the technology.
We tried to define categories when reading but it was sometimes
difficult to parse.
User needs User actions Technology
-----------------------------------------------------------------
Sharing email adding rel="foaf:mbox" triple with
foaf:mbox
In user needs, sometimes, it's not clear that there is a direct
relation between user needs and user actions. Sometimes a practical
piece of code would be helpful in demonstrating, greasemonkey script,
etc.
For now, all examples are only usable in XHTML 2.0 (WD), it should be
reminded each time the document gives markup or at least in the
introduction stated very clearly.
--
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 May 2006 05:50:47 UTC