erebion/libervia-backend
Watch
1
0
Fork
You've already forked libervia-backend
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

doc (components): Document the handling of mailing lists in Email Gateway:

Browse source 
fix 462
This commit is contained in:
Goffi 2025-08-03 23:45:48 +02:00
commit 009ef1aa4b
1 changed files with 15 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

15
doc/components.rst
View file

@ -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