RDFa Primer comments

Just a handful of comments:

Section 1 is a duplicate of the Abstract.  This is unusual... I would 
not duplicate the content.

Not a big fan of W3C specs saying "we do this" or "you do that". Specs 
are typically third person.  Anyway.  I would change section 1 paragraph 
3 to read:

    The following namespaces are used throughout this document:

I suspect the stuff about a BBQ used to be about a talk.  There are 
several places where the word "talk" is still used.

Sometimes element names are in upper case and sometimes in lower case.  
Since we are talking about XHTML here you should always use lower case.  
Also, I would adopt the convention of citing attribute names by starting 
them with an @ sign.  This might mean you need to have a little but 
about notation conventions at the front.

There are some examples that are nearly complete documents.... XHTML 
documents require a DOCTYPE declaration and an xmlns declaration for the 
XHTML namespace.  The examples should all reflect that I think.

Section 2.5 talks about using standard XML Namespaces.  If you believe 
that, then I am okay with it.  I think RDFa uses compact URIs that 
expand prefixes defined using the XML Namespace conventions.

Section 3.3 the example is indented A LOT.  Could pull it back.

Also it says we use XML data types.  We use XML Schema data types I think.

Section 3.4 first example seems to be missing its markup.

Section 3.5 the final example is way wide...

Section 3.6 overriding href should also be @src

Also in that section it says "clickable".  Icky non-accessible term.  
How about "selectable" or "navigable" ?

Section 4.5 is also called Overriding @href....   Should include @src 
and hrm - sort of a duplicate of 3.6?

That's all I saw.

-- 
Shane P. McCarron                          Phone: +1 763 786-8160 x120
Managing Director                            Fax: +1 763 786-8180
ApTest Minnesota                            Inet: shane@aptest.com

Received on Thursday, 13 September 2007 20:03:52 UTC