Clean up

* Trailing whitespace
* Rename .json.example to -sample.json so that extension
  and syntaxhighlighing works when viewing and editing the
  sample file.
* Replace '==' with '@' in the readme (textile == doesn't
  work on github), and add a few more.
* Minor phrasing changes.