all tests pass, readme updated