changeset 3874:c2b292d30c66 default tip @

doc (components/AP gateway): "repeat" and "noticed/like": fix 370
author Goffi <>
date Fri, 22 Jul 2022 17:40:03 +0200
parents 8b76caa89aa0
files doc/components.rst
diffstat 1 files changed, 27 insertions(+), 0 deletions(-) [+]
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):
+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:
+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:
+.. _XMPP Council:
+.. _"noticed" instead of "like" or "favourite":
 Using the Component (for developers)
@@ -686,3 +712,4 @@
 Note the double escaping, one for the shell argument, and the other to specify JSON