From bc63bedcab3454f11c79fcdbcf90301deb562b6c Mon Sep 17 00:00:00 2001
From: nescias <nescias@posteo.de>
Date: Mon, 11 May 2026 16:21:51 +0000
Subject: [PATCH] email: add warning to documentation of `useStartTls`

---
 modules/accounts/email.nix | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/modules/accounts/email.nix b/modules/accounts/email.nix
index d57528e0a..1e32ae665 100644
--- a/modules/accounts/email.nix
+++ b/modules/accounts/email.nix
@@ -109,7 +109,9 @@ let
         type = types.bool;
         default = false;
         description = ''
-          Whether to use STARTTLS.
+          Whether to use STARTTLS. This is discouraged and should be avoided if
+          possible. See <https://datatracker.ietf.org/doc/html/rfc8314> for
+          more.
         '';
       };