Finish README

updated for the readme-changes branch