Updates on the documentation:
Formatting changes, typo fixes, rephrased several paragraphs to make
documentation easier to read and understand.
several typo fixes and logging improvements
Merge pull request #55 from mbartosch/develop

Develop