Improved documentation with example

[bsutton]

Thanks for the great package.

It would be really helpful if the documentation included a worked example.