readme.md is now consistent with the implementation