document the signature of the validation function of params()