Readme edits, Fixes #1 and issue number x

Ok to merge this complex changes?