First set of changes

Making a commitment to these changes.
Merge pull request #2 from jandrieu1/readme-edits

First set of changes, fixes #1