first commit on branch readme-edits

Request for merge