# HG changeset patch
# User Goffi <goffi@goffi.org>
# Date 1754257548 -7200
# Node ID a6270030968d0e448ec7c704cadd7a455e9dc978
# Parent  c055042c01e38d7cecb908b9ad8312a27ee853e3
doc (components): Document the handling of mailing lists in Email Gateway:

fix 462

diff -r c055042c01e3 -r a6270030968d doc/components.rst
--- a/doc/components.rst	Sun Aug 03 23:45:48 2025 +0200
+++ b/doc/components.rst	Sun Aug 03 23:45:48 2025 +0200
@@ -995,11 +995,26 @@
    Gateway Relayed Encryption is not yet an official XEP, it will be evaluated by XMPP
    council to see if it gets an official number in coming weeks.
 
+Mailing Lists
+~~~~~~~~~~~~~
+
+Emails parts of mailing lists are detected and handled separately. They are converted to
+Pubsub blog nodes: the list identifier is used as the pubsub node, and each topic is added
+as a `XEP-0277 (Microblogging over XMPP)`_ item. Replies to a specific topic (i.e. in a
+thread) are set as comments to the corresponding item.
+
+If a title has some words between square brackets (``[like][this] Within the title``)
+they are removed and added as blog tags (aka categories).
+
+Only the JID associated to the recipient of the mailing list can access the pubsub node.
+It will be possible to make a mailing list public in the future.
+
 
 .. _XEP-0033 (Extended Stanza Addressing): https://xmpp.org/extensions/xep-0033.html
 .. _XEP-0100 (Gateway Interaction): https://xmpp.org/extensions/xep-0100.html
 .. _XEP-0106 (JID Escaping): https://xmpp.org/extensions/xep-0106.html
 .. _XEP-0131 (Stanza Headers and Internet Metadata): https://xmpp.org/extensions/xep-0131.html
+.. _XEP-0277 (Microblogging over XMPP): https://xmpp.org/extensions/xep-0277.html
 .. _XEP-0498 (Pubsub File Sharing): https://xmpp.org/extensions/xep-0498.html
 .. _Wikipedia's Autocrypt page: https://en.wikipedia.org/wiki/Autocrypt