Some editing, part 1

Hi,
Here's my first pass to improve some of the wording in the readme and the example.

Please apply the HTML part to your gh-pages branch too.


--Adam