I reverted these changes to the documentation.  The behavior in model validate still has to be there for the purpose of form.commit, but at least now the implementation can be changed without breaking public behavior.