From 4968d4c8b7eb0bf6fb83247aec15d054e937c86a Mon Sep 17 00:00:00 2001
From: Ginger <ginger@gingershaped.computer>
Date: Wed, 20 May 2026 11:35:01 -0400
Subject: [PATCH] docs: Clarify documentation for
 `require_email_for_registration`

---
 conduwuit-example.toml | 9 ++++++---
 src/core/config/mod.rs | 9 ++++++---
 2 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/conduwuit-example.toml b/conduwuit-example.toml
index 42c64d7fe..255cda3cf 100644
--- a/conduwuit-example.toml
+++ b/conduwuit-example.toml
@@ -1959,8 +1959,10 @@
 #
 #sender =
 
-# Whether to require that users provide an email address when they
-# register.
+# Whether to allow public registration with an email address.
+#
+# Note that, if this option is enabled, anyone will be able to register an
+# account with just an email address.
 #
 # If either this option or `require_email_for_token_registration` are set,
 # users will not be allowed to remove their email address.
@@ -1968,6 +1970,7 @@
 #require_email_for_registration = false
 
 # Whether to require that users who register with a registration token
-# provide an email address.
+# provide an email address. This option is independent of
+# `require_email_for_registration`.
 #
 #require_email_for_token_registration = false
diff --git a/src/core/config/mod.rs b/src/core/config/mod.rs
index cc00a01f4..284e78bcc 100644
--- a/src/core/config/mod.rs
+++ b/src/core/config/mod.rs
@@ -2318,8 +2318,10 @@ pub struct SmtpConfig {
 	/// - `address@domain.org` to not use a name
 	pub sender: Mailbox,
 
-	/// Whether to require that users provide an email address when they
-	/// register.
+	/// Whether to allow public registration with an email address.
+	///
+	/// Note that, if this option is enabled, anyone will be able to register an
+	/// account with just an email address.
 	///
 	/// If either this option or `require_email_for_token_registration` are set,
 	/// users will not be allowed to remove their email address.
@@ -2329,7 +2331,8 @@ pub struct SmtpConfig {
 	pub require_email_for_registration: bool,
 
 	/// Whether to require that users who register with a registration token
-	/// provide an email address.
+	/// provide an email address. This option is independent of
+	/// `require_email_for_registration`.
 	///
 	/// default: false
 	#[serde(default)]