Improve usage examples in README

[jhermsmeier]

Connects to #10

[jviotti]

Looks good, and I'll approve, however I wonder if we should be auto-generating this from JSDoc annotations instead.

[jhermsmeier]

however I wonder if we should be auto-generating this from JSDoc annotations instead.

That would of course be preferable, but would make it more complicated to show off things like verification (as it's not a method, and thus doesn't have docs associated), and also splitting the quite noisy API docs from these examples. Or is there a beautifully easy way of doing this?

[jviotti]

I believe you can include module-scope examples, while also provide some docs for the methods/properties, but definitely not high priority for now. We can experiment with it after v1.

[jhermsmeier]

Aye, sounds good.