Updating readme

Adds Usage and API sections and links to other examples to the readme.

Note that this will break the links in the examples until the `gh-pages` branch is pushed.