#129/#133 - updated method comments and README.md

# Changes

* Updated methods comments which resolves #133 
* Updated README.md which resolves #129