RDFa Primer WD#2 - Addressing DBooth's Comments from WD#1

David,

The Primer is ready for you to review at:
http://www.w3.org/2001/sw/BestPractices/HTML/2006-04-24-rdfa-primer

(you'll need a Mozilla-based browser to see it, as it's XML with XSLT).

Your comments on our WD#1 (before the URI information resource issue)  
are at [1]. I wanted to let you know how we addressed these comments  
in WD#2 to help your review:

> 1. Sec 3.1, where "dc:" first appears, it would be good to mention
> (forward reference) that Sec 4.4 will explain how the dc: prefix is
> defined.

The new Section 2 should address these introductory issues better.  
Let us know if this is still problematic.

> 2. Sec 3.2, I suggest changing:
> [[
> Using the rel attribute, one can easily update this HTML to include an
> RDF/A statement:"
> ]]
> to mention that rel expects a sibling href attribute.  Perhaps  
> something
> like:
> [[
> Using the rel attribute (which expects a sibling href attribute), one
> can easily update this HTML to include an RDF/A statement:"
> ]]
>
> Also add something like the following just before the paragraph that
> begins "Similarly, Shutr may want to give its users":
> [[
> Because the rel attribute was used, the RDF property value came  
> from the
> href attribute instead of coming from the body of the <a> element.
> ]]

The new phrasing and introduction should also improve the situation  
there, and there's now similar language to what you suggested.

> 3. Sec 3.2, next-to-last paragraph, the word "is" is repeated,:  
> once in
> italics and once plain.

Nice catch, fixed!

> Sec 4.1: I started wondering: Does XMLLiteral trim leading and  
> trailing
> whitespace?  Maybe it would be good to mention how/where this is
> treated.

We haven't fixed this issue yet.

> 4. Sec 4.2, first paragraph: s/from a parent/from a parent or  
> ancestor/

fixed.

> 5. Sec 4.3: Extra space before ":" after "which behave in a special
> way".

fixed.

> 6. Sec 4.4: I suggest putting the paragraph break before "A CURIE,  
> e.g.,
> dc:title" instead of before "We now address URI duplication".

fixed according to your suggestion.

-Ben

Received on Wednesday, 26 April 2006 14:31:45 UTC