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