Patch/documentation

Improved documentation.

* Included example use cases.
* Added details on the module's API

Resolves #16