update readme and pass doc to valueIsAllowed; closes #6