summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKonstantin Ryabitsev <konstantin@linuxfoundation.org>2023-11-22 10:30:49 -0500
committerKonstantin Ryabitsev <konstantin@linuxfoundation.org>2023-11-22 10:30:49 -0500
commitcf1512bcdf8e11c7f5b6e74ae2435e716a73824e (patch)
tree0f15aaa6b1111f2fc0c7bfb6ca58f0cb35ec25aa
parente1fa0fb80dec8b558386ac5fe399ae7efb6a03de (diff)
downloadsite-cf1512bcdf8e11c7f5b6e74ae2435e716a73824e.tar.gz
Fix warnings and add a note on gmail
Tell people to avoid using gmail when subscribing to high-volume lists. Signed-off-by: Konstantin Ryabitsev <konstantin@linuxfoundation.org>
-rw-r--r--subscribing.rst27
1 files changed, 20 insertions, 7 deletions
diff --git a/subscribing.rst b/subscribing.rst
index 3a289c3..459ca3c 100644
--- a/subscribing.rst
+++ b/subscribing.rst
@@ -1,7 +1,8 @@
Subscribing to lists
====================
-.. important:
+.. note::
+
Most lists do not require subscribing in order to post a message, so
you only need to subscribe if you are interested in receiving a copy
of all mail messages sent to the list.
@@ -15,20 +16,32 @@ send a message to a special subscription address of the list.
For example, if you want to subscribe to ``test@lists.linux.dev``:
- to receive an **individual copy of every message sent to the list**,
- send an email to ``test+subscribe@lists.linux.dev``
-- to receive a **daily digest of all messages sent to the list**,
- send an email to ``test+subscribe-digest@lists.linux.dev``
+ send an email to::
+
+ test+subscribe@lists.linux.dev
+
+- to receive a **daily digest of all messages sent to the list**,
+ send an email to::
+
+ test+subscribe-digest@lists.linux.dev
The subject or body of the message do not make a difference and can be
left blank.
+.. warning:: If you use Gmail
+
+ If you are a Gmail user, please do not subscribe to high-volume
+ lists, because this will almost certainly push you over Gmail's
+ delivery quotas (60 messages per second, specifically). This may
+ cause you to miss important mail.
+
Unsubscribing to stop receiving list mail
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
To stop receiving mail from any list, send a message to the unsubscribe
address of the list. For example, to unsubscribe from either the full or
-digest version of the test list, use the same address:
+digest version of the test list, send a message to::
-- send a message to ``test+unsubscribe@lists.linux.dev``
+ test+unsubscribe@lists.linux.dev
Subscribing via NNTP
--------------------
@@ -38,7 +51,7 @@ you can subscribe to it via NNTP.
In your usenet-capable client, provide the following NNTP server to use:
-- nntp://nntp.lore.kernel.org
+- ``nntp://nntp.lore.kernel.org``
Once the connection is established, you can retrieve the list of groups
and subscribe to the list you need.