fix typos in README
more doc updates
Merge pull request #26 from bodepd/doc_updates_3

Doc updates 3