Updating README.md

Here are the changes to the README.md file I am proposing. These come from a discussiong I had with Peter via emails.