From 009ef1aa4bc6063987e930317b1509cd33ed55a5 Mon Sep 17 00:00:00 2001 From: Goffi Date: Sun, 3 Aug 2025 23:45:48 +0200 Subject: [PATCH] doc (components): Document the handling of mailing lists in Email Gateway: fix 462 --- doc/components.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/components.rst b/doc/components.rst index ad5d5557..0f313219 100644 --- a/doc/components.rst +++ b/doc/components.rst @@ -995,11 +995,26 @@ security model 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