Re: Primer Update (feedback)

Ben Adida wrote:
> http://www.w3.org/2006/07/SWD/RDFa/primer/20070910/

Feedback on the 20070910 Primer:

- Really great job on getting the concepts more accessible to web
  developers! I really couldn't justify changing too much, this
  version seemed much more polished than the last.
- Can we use color or highlight the important parts of the XHTML code in
  some way? It is hard to differentiate the text that matters to RDFa
  from the text that doesn't in some of the larger examples.
- The scenarios were much easier to follow this time around.
- The document looks very scary and large in a web browser. I realize
  that it might be against W3C policy to break up a large page, like the
  Primer document, into multiple pages... but it really needs it. The
  HTML 4.01 Specification does it:
  http://www.w3.org/TR/html4/cover.html#minitoc
- The rest of the feedback is attached (tiny grammar corrections,
  missing words, etc). Changes are highlighted in yellow.

Even without the proposed changes, the document is much more accessible
and streamlined from the last revision. Later today, I'll pass it by
some of our developers that don't know anything about RDFa and see what
they have to say.

-- manu

-- 
Manu Sporny
President/CEO, Digital Bazaar, Inc.
http://wiki.digitalbazaar.com/en/BTPWS-Album-Recommendation