New Editors draft of RDFa API spec

I spent most of the day today going through the RDFa API examples and
making editorial changes - fixing examples and bugs mostly. There is a
new version of the RDFa API spec available here:

http://www.w3.org/2010/02/rdfa/sources/rdfa-api/

Changes include:

* Lots of examples updates - changed Javascript console-based
  examples as they were confusing for a variety of different reasons.
  This includes almost 50% of the example code we had, some of which
  was completely wrong because the API has changed over the last several
  months. Updated to use comments to describe what each statement does,
  added colorized comments to distinguish code more clearly.
* Added type parameter to createQuery - we had an example that
  specified a type, but the interface definition was missing the type
  parameter. Without this parameter, one wouldn't be able to create
  implementations that supported things like SPARQL queries.
* Added the DataStoreIterator callback interface as we had forgotten to
  formally define what the callback interface looks like in WebIDL.
* Fixed bug in the getItemsBySubject call - we were returning a
  PropertyGroupList. That didn't make any sense - you can only have one
  PropertyGroup associated with a subject since there is a 1-to-1
  mapping between subjects and PropertyGroups. We also shouldn't have
  a getItemsBySubject call - it's getItemBySubject - note the missing
  's' in Item. We also shouldn't have had PropertyGroupList... the
  proper WebIDL is Sequence<PropertyGroup> or PropertyGroup[] - still
  need to do some research to figure out which one to use. Either a
  Sequence is immutable, or a [] - forget which one's which.
* Fixed two CSS layout bugs in ReSpec CSS file used by RDFa API
  spec.

If someone could read over the examples and find any bugs, that would be
great. Or read over the document and find inconsistencies would be great
too. I'll mint a new time-stamped ED URL at the end of the weekend, so
if you have any urgent comments on the document, please get them in
before then.

-- manu

-- 
Manu Sporny (skype: msporny, twitter: manusporny)
President/CEO - Digital Bazaar, Inc.
blog: WebID - Universal Login for the Web
http://blog.digitalbazaar.com/2010/08/07/webid/2/

Received on Sunday, 5 September 2010 00:34:25 UTC