update README.md with notes