# HG changeset patch
# User Goffi <goffi@goffi.org>
# Date 1661958423 -7200
# Node ID ba78cc0c8d5935621895daa58530c61c063db98d
# Parent  989df1047c3c46012541fb48bd06266a8fb76bc2
doc (components/AP gateway): "reactions":

fix 371

diff -r 989df1047c3c -r ba78cc0c8d59 doc/components.rst
--- 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.
-