Merge pull request #4 from mkurek/feature/docs

api description updated
documentation improvement (grammar etc)