Move documentation to docstrings

In order to keep usage details in one place it was decided to move it
into docstrings so we can use them in sphinx docs. If we need more -
we can add respective comments directly to sphinx docs.

Resolves #1
Resolves #2