Readme edits - first pull request

This is the comment for the first pull request - which is for discussion in the team..it merges a branch with the master.