Describe usage examples in docs

[cfoehrdes]

The readme section for usage is missing a basic usage scenario. In addition it would be useful to have some examples for common use cases.