Update readme, Fixes #1

Content for humans and machines