Clarified readme and examples

[Globegitter]

Just to make it a bit easier if other people are looking for this kind of functionality and stumbling upon this very useful package.

[twokul]

@Globegitter thanks!