RDFa in XHTML Feedback/Edits

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

Received on Thursday, 13 September 2007 06:18:49 UTC