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
