added documentation for the new #validate method override