README changes #1

updated for the readme-changes branch