Update README fixes/clarifications
Merge pull request #8 from marios/readme_clarifications

Update README fixes/clarifications