update README.md and associated files