improved documentation in README.md files