improve documentation, add examples

The examples come from the README.md (which is really only for github's
benefit) after cleaning up that same README.md a little bit first.
bump version to 0.2, give credit to @hmalmedal

Things are so much better with @halmedal's reworking. Thanks!