Rewrite the README

* Add comprehensive examples for every method in the API
* Change Shoulda references to shoulda-matchers
* Mention that we use SemVer