Readme edits, fixes#1

Content for github documentation