[xhtml2] Half English/Half ntriples syntax - Bad writing

Hi,
This is a QA Review comment for "XHTML 2.0"
http://www.w3.org/TR/2006/WD-xhtml2-20060726/
2006-07-26
8th WD

About http://www.w3.org/TR/2006/WD-xhtml2-20060726/mod-meta.html#sec_23.4.1.

There are examples with an half English/ntriples syntax, which will be understood only by people with a knowledge of RDF.

 [[[
 this document has an 'author' property of "Mark Birbeck";
 this document has a 'created' property of "2004-03-20".
 ]]]

Make it more step by step. Something on the line.

 [[[
 Every document has properties. For example a book has an author, a publisher, an ISBN number, a date of publication. In the same way an HTML document has properties which can be expressed with the meta element. 
 
 For example, we can consider an XHTML 2.0 document written by Mark  Birbeck on March 20, 2004.
 "Mark Birbeck" is the author of the document
 "March 20, 2004" is the creation date of the document.
 
 Dublin Core is an organization which has defined properties for documents [DUBLIN-CORE].
 
 The property for labelling the author is "dc:creator"
 The property for labelling the creation date is "dc:created"

Then in XHTML 2.0, it can be expressed with the following markup:

 "<head>
     <meta property="dc:creator">Mark Birbeck</meta>
     <meta property="dc:created" content="2004-03-20" />
   </head>
 "
 ]]]
 
Do not assume too much about the level of knowledge of your readers. Other paragraphs in the same page needs the same kind of rewriting.




-- 
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 Thursday, 17 August 2006 03:28:51 UTC