update docs to reflect validate_parameters()