update readme.md files and some minor cleanup