Update README.md

Add links to documentation
Merge pull request #2 from dgageot/patch-3

Update README.md (added links, lexical fixes, etc.)