all tests pass, update readme with some usage based on tests