update main README file to markdown
minor typo corrections and new links to github resources
Fix bad link
fix typo
shrink commit SHA
more doc updates