update docs and tests in README.md