README: updated docs to final interface

`that passed validation` explains it without reusing the name of the function