docs: new IEmailValidator::isValid

Signed-off-by: Daniel Kesselberg <mail@danielkesselberg.de>

Author: kesselb

developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_32.rst

@@ -128,6 +128,8 @@ Added APIs
   - New task processing task type ``OCP\TaskProcessing\AnalyzeImages`` to ask questions about images.
   - New method ``OCP\TaskProcessing\Manager::getAvailableTaskTypeIds`` to list only task type IDs without meta-data (faster than ``OCP\TaskProcessing\Manager::getAvailableTaskTypes``)
 
+- New ``OCP\Mail\IEmailValidator`` to validate an email address.
+
 Changed APIs
 ^^^^^^^^^^^^
 
@@ -147,6 +149,7 @@ Deprecated APIs
 - ``\OC_User::clearBackends`` is deprecated, please use ``\OCP\IUserManager::clearBackends`` available since 8.0.0
 - ``\OC_Helper::isReadOnlyConfigEnabled`` is deprecated, please use the ``config_is_read_only`` system config directly.
 - ``\OCP\OCM\IOCMProvider`` is deprecated, please use ``\OCP\OCM\ICapabilityAwareOCMProvider`` available since 32.0.0
+- ``\OCP\Mail\IMailer::validateMailAddress`` is deprecated, please use ``\OCP\Mail\IEmailValidator`` available since 32.0.0
 
 Removed APIs
 ^^^^^^^^^^^^