RDFa Primer update

Hey folks,

I had promised Ivan on one of the calls that I would make a sweep
through the RDFa Primer and update the grammar, structure and flow of
the document. I spent most of this weekend updating the document and I
think I'm done. A publish-able Working Draft for the RDFa Primer has
been prepared. It is dated for the publish date that we agreed upon last
Thursday:

http://www.w3.org/2010/02/rdfa/drafts/2011/WD-rdfa-primer-20110419/

You can see the changes that I made in a diff-marked version from Ivan's
version as of April 8th 2011:

http://www.w3.org/2010/02/rdfa/drafts/2011/WD-rdfa-primer-20110419/diff-rdfa-primer-20110408.html

The majority of the changes were prose/flow/grammar related in each
section, but I tried to keep the majority of the sections in the same
order. That is, the overall structure of the document is the same, but
lots of changes were made in each section. Nothing much was changed
conceptually, just the precise wording used to explain each concept.

Updates:

* Lots of grammar and prose cleanups/fixups/rewording
* Fixed headers and document links to previous pubs/drafts
* Removed mentions of company names such as Facebook (except in
  appendix A, as it seemed to make sense there)
* Made the way we express attributes consistent in the document:
  "the <code>about</code> attribute" instead of "<tt>@about</tt>"
* Moved the advanced examples into an appendix.

Problems:

* The document has not been put through the W3C pubrules checker yet.
* We are using OGP in a way that is not consistent with the way that it
  is read from a page. The OGP examples in the primer will not work in
  the real world. We need to discuss this for the final version of the
  document, but shouldn't let it keep us from publishing the Working
  Draft.

-- manu

-- 
Manu Sporny (skype: msporny, twitter: manusporny)
President/CEO - Digital Bazaar, Inc.
blog: The PaySwarm Vocabulary
http://digitalbazaar.com/2011/03/31/payswarm-vocab/

Received on Sunday, 10 April 2011 21:55:27 UTC