minor bug fixes and updated readme
Editing README

Mainly changes for formatting, but also some minor content changes to
clarify things.
Fixed Guillermos comments
Merge pull request #107 from johandahlberg/feature/clean_up_docs

Minor README changes
Merge pull request #106 from guillermo-carrasco/master

Documentation++