- From: Manu Sporny <msporny@digitalbazaar.com>
- Date: Thu, 13 Sep 2007 02:18:16 -0400
- To: RDFa mailing list <public-rdf-in-xhtml-tf@w3.org>
- Message-ID: <46E8D628.4040705@digitalbazaar.com>
Here's feedback from a full read through the RDFa in XHTML Syntax and Processing document. High level notes: - We should color code the important RDFa parts of the XHTML examples. - Section 2: Orientation is not very useful. It is so high level and it explains so little that we might as well not have it in there. We could replace the entire section with a link that says "Go read the RDFa Primer before you read this document". - The language in sections 1, 2 and 3 need quite a bit of cleanup. I did my best to correct as much as I could. The biggest problems tended to be very long sentences separated by semicolons. Comma splices abound. More verbose than necessary in several places. - There are consistency issues between the RDFa Primer and this document, such as using 'bnode' instead of 'blank node' and using xsd:date in the Primer and xs:date in the Syntax document. - Section 4 is very good. - Section 5 is fantastic and provides the best kind of information for developers: examples followed by what triples should be generated from the examples. - Section 5.3 would be helpful if it were outlined in the Orentation section. The complete set of edits are attached. Additions are highlighted in yellow. Deletions are highlighted in yellow and are strike-through. -- manu -- Manu Sporny President/CEO, Digital Bazaar, Inc. http://wiki.digitalbazaar.com/en/haudio-case-study
Attachments
- text/html attachment: stored
Received on Thursday, 13 September 2007 06:18:49 UTC