improvements to the readme.md file