documentation improvement (grammar etc)
api doc: new lines
costs doc: new lines
Merge pull request #5 from mkurek/feature/docs

documentation improvement (mainly grammar)