Consistant API documentation in README #57
Description
As @bmitch pointed out in #55 it does seem a little inconsistent between when we're showing a full example and a snippet of code.
Maybe this is just a case of adding something like ... snip to the smaller API examples to make it more clear.
@AydinHassan thoughts?