making changes to readme file on the readme-edits branch

hopefully I will be able to merge my changes easily back to the master
hopefully this will get merged back to the master