W3C home > Mailing lists > Public > public-rdf-in-xhtml-tf@w3.org > September 2007

Re: update on Primer

From: Manu Sporny <msporny@digitalbazaar.com>
Date: Tue, 04 Sep 2007 23:39:42 -0400
Message-ID: <46DE24FE.1070509@digitalbazaar.com>
To: RDFa mailing list <public-rdf-in-xhtml-tf@w3.org>
Ben Adida wrote:
> I've done quite a bit on the Primer, though I likely won't get more done
> until Thursday's call. 

Awesome! It's much easier to read now. Attached are edits and thoughts
for the first three sub-sections of the document.

Further improvements that we could make:

- Fine tune the examples to resonate with a wider audience (talk about
  picnics and BBQs, not talks at web conferences)
- Make the language less technical sounding (replace phrases like
  "inherent structured data about an event" with "event information")
- Split the Primer up into multiple sections on different pages. The
  Python Library Reference is a good example of making a large document
  seem like an easy read:
  http://docs.python.org/lib/types.html

I could help edit the rest of the document if these are the types of
changes and feedback that you need. It's looking much better already :)

-- manu

-- 
Manu Sporny
President/CEO, Digital Bazaar, Inc.
http://blog.digitalbazaar.com/


Received on Wednesday, 5 September 2007 03:40:11 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 17:01:52 UTC