Merge pull request #11490 from nextcloud/update-changelog-26

feat(adminmanual): Amend upgrade notes about mailer changes in 26

admin_manual/release_notes/upgrade_to_26.rst

@@ -11,7 +11,16 @@ System requirements
 System email
 ------------
 
-The software component to send system emails (notifications, invites, password reset, etc) had to be replaced. The new library should work without any changes out of the box for most setups. Only NTLM/Exchange is kown to be no longer supported. See :ref:`email-smtp-config`.
+The software component to send system emails (notifications, invites, password reset, etc) had to be replaced. The new library should work without any changes out of the box for most setups.
+
+A brief overview of changes:
+
+* STARTTLS cannot be enforced. It will be used automatically if the mail server supports it. The encryption type should be set to 'None/STARTTLS' in this case.
+* Self signed certificates now need to be explicitly enabled, see :ref:`this guide<TLSPeerVerification>` for an example on how to configure this.
+* NTLM authentication for Microsoft Exchange is not supported by the new mailer library. Try using `basic authentication <https://learn.microsoft.com/en-us/exchange/client-developer/exchange-web-services/authentication-and-ews-in-exchange#basic-authentication>`_ instead.
+
+See for more information: :ref:`email-smtp-config`.
+
 
 Web server configuration
 ------------------------