comments on 12-sep RDFa Primer ED

Ben,

As others have already said, great job on the latest RDFa Primer
editors' draft.  Again, rather than transcribe my notes into plain text,
I've scanned my marked-up hardcopy and sent it to you in separate
mail [1].  Apologies for the handwriting; I did much of this while
riding the train.  Please ask me about anything that needs
interpretation or clarification.

   [1] <http://lists.w3.org/Archives/Public/www-archive/2007Sep/0048.html>

A few semi-editorial comments I'll mention here:

1. While it's nicer to read XML that has lots of line breaks, as
   we discussed on a recent telecon XHTML requires that whitespace
   be preserved so line breaks at the beginning and end of element
   content will strictly lead to whitespace in the literal values.
   I recommend collapsing lines where the whitespace is not
   intended as part of the literal, as was mostly done in the
   Syntax document.

2. Nit that bothers me :) -- I suggest renaming the property
   currently called "shutterSpeed" to "frameRate".  There's
   another more conventional interpretation of "shutter speed".

3. I suggest changing the title of section 4.2 to something
   more descriptive for the ToC, such as "Advanced Data" to
   align with the title of section 3.

4. Shane belongs in the acknowledgements.  (I know no
   slight was intended!)

My all-day meetings continue today, so I'm not caught up on email.
Apologies for whatever duplication exists in these notes. I see no
reason not to proceed with full WG review and move to publication
of this draft. 

-Ralph

Received on Thursday, 13 September 2007 12:38:39 UTC