ACTION-108: RDFa Lite 1.1 Comments

Some comments on RDFa Lite 1.1 as per my action item:

Disclaimer:  I am an "Oxford Comma Nazi".

Section 1:

It says "The goal was..."  I think it should be "The goal is...".  
Active voice. Present tense.

Section 2.1 - the title should be "vocab, typeof, and property"

paragraph 2 - "As you will note above, we have specified..." is 
awkward.  How about "In this example we have specified..."

Section 2.2

It says "Uniform Resource Locator (URL)"  Do we still say URL? I thought 
it was URI?  or IRI?

Section 2.3

says "such as|dc|,|foaf|and|schema|."  It should be "such 
as|dc|,|foaf,|and|schema|."

Section 3:

This sentence "As well as sections marked as non-normative, all 
authoring guidelines, diagrams, examples, and notes in this 
specification are non-normative. Everything else in this specification 
is normative."  is awkward.  How about "All authoring guidelines, 
diagrams, examples, and notes in this specification are non-normative. 
Sections marked specifically as 'non-nomative' are also non-normative.  
Everything else in this specification is normative."

or something...

Section 3.1:

It says "In order for a document to be labeled as a conforming*RDFa Lite 
1.1 document*, it/must/provide the facilities described as mandatory in 
its Host Language and it/must not/use any additional RDFa attributes 
other than those described in this specification"  This isn't quite 
right.  I think we mean "In order for a document to be labeled as a 
conforming*RDFa Lite 1.1 document*, it/must/only require the facilities 
described as mandatory in its Host Language and it/must not/use any 
additional RDFa attributes other than those described in this specification"

Otherwise it looks great!

-- 
Shane McCarron
Managing Director, Applied Testing and Technology, Inc.
+1 763 786 8160 x120

Received on Wednesday, 18 January 2012 03:11:58 UTC