diff doc/components.rst @ 3874:c2b292d30c66

doc (components/AP gateway): "repeat" and "noticed/like": fix 370
author Goffi <goffi@goffi.org>
date Fri, 22 Jul 2022 17:40:03 +0200
parents 9a53b513ae55
children 18ff4f75f0e6
line wrap: on
line diff
--- a/doc/components.rst	Fri Jul 22 17:16:28 2022 +0200
+++ b/doc/components.rst	Fri Jul 22 17:40:03 2022 +0200
@@ -662,6 +662,32 @@
 
 .. _XEP-0372 (References): https://xmpp.org/extensions/xep-0372.html
 
+Repeat/Share/Reboost
+~~~~~~~~~~~~~~~~~~~~
+
+The repeat feature (also named "share", or "boost") which consist of republishing an item
+of interest under our own account to make it visible to our subscribers, is done on the
+XMPP side with `XEP-0277 § Repeating a Post`_, and on the AP side it's an ``Announce``
+activity. Conversion is done in both directions and should be transparent to user.
+
+.. _XEP-0277 § Repeating a Post: https://xmpp.org/extensions/xep-0277.html#repeat
+
+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
+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).
+
+As usual, conversion is done in both ways.
+
+.. _Pubsub Attachment: https://xmpp.org/extensions/inbox/pubsub-attachments.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
+
 Using the Component (for developers)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -686,3 +712,4 @@
 
 Note the double escaping, one for the shell argument, and the other to specify JSON
 object.
+