diff doc/components.rst @ 3892:ba78cc0c8d59

doc (components/AP gateway): "reactions": fix 371
author Goffi <goffi@goffi.org>
date Wed, 31 Aug 2022 17:07:03 +0200
parents 18ff4f75f0e6
children 199598223f82
line wrap: on
line diff
--- a/doc/components.rst	Wed Aug 31 17:07:03 2022 +0200
+++ b/doc/components.rst	Wed Aug 31 17:07:03 2022 +0200
@@ -675,18 +675,35 @@
 Noticed/Like
 ~~~~~~~~~~~~
 
-AP's ``Like`` activity is converted on the XMPP side to "`Pubsub Attachment`_", which is
-currently a "protoXEP", i.e. a specification proposed as a standard (not yet reviewed by
-`XMPP Council`_). ``Like`` is converted to ``noticed`` attachment, meaning that it used in
+AP's ``Like`` activity is converted on the XMPP side to "`XEP-0470 (Pubsub
+Attachments)`_". ``Like`` is converted to ``noticed`` attachment, meaning that it used in
 to indicate that something has been seen and taken into account, without really indication
-if the content is liked or disliked (see Pubsub Attachment § Foreword: `"noticed" instead
-of "like" or "favourite"`_ for the rational).
+if the content is liked or disliked (see XEP-0470 § Foreword: `"noticed" instead of "like"
+or "favourite"`_ for the rational).
 
 As usual, conversion is done in both ways.
 
-.. _Pubsub Attachment: https://xmpp.org/extensions/inbox/pubsub-attachments.html
+.. _XEP-0470 (Pubsub Attachments): https://xmpp.org/extensions/xep-0470.html
 .. _XMPP Council: https://xmpp.org/about/xmpp-standards-foundation/
-.. _"noticed" instead of "like" or "favourite": https://xmpp.org/extensions/inbox/pubsub-attachments.html#noticed-foreword
+.. _"noticed" instead of "like" or "favourite": https://xmpp.org/extensions/xep-0470.html#noticed-foreword
+
+Reactions
+~~~~~~~~~
+
+Reactions are not specified in `base ActivityPub specification`_. However `Pleroma`_, a
+software implemeting ActivityPub, implements them using a non standardised (yet?)
+``EmojiReact`` activity. Liberva AP Gateway use it to handle reactions.
+
+On the XMPP side, `XEP-0470 (Pubsub Attachments)`_ is once again used.
+
+Libervia also implements `XEP-0444 (Message Reactions)`_ for messages, but because Pleroma
+doesn't handle reactions for direct messages, this is not used in the Libervia AP gateway.
+If in the future an AP implementation uses reactions on direct messages, it will be
+straightforward to add it in the AP gateway.
+
+.. _base ActivityPub specification: https://www.w3.org/TR/activitypub/
+.. _Pleroma: https://pleroma.social/
+.. _XEP-0444 (Message Reactions): https://xmpp.org/extensions/xep-0444.html
 
 Using the Component (for developers)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -712,4 +729,3 @@
 
 Note the double escaping, one for the shell argument, and the other to specify JSON
 object.
-