aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorredmatrix <git@macgirvin.com>2016-04-04 17:02:27 -0700
committerredmatrix <git@macgirvin.com>2016-04-04 17:02:27 -0700
commit1d5ea5efae2262f80c9efb4f6bf0cafbf64f1a4b (patch)
tree7d35e74e784890ec87bbdd8ea3e43cd6bec25680 /doc
parent01ad485f6517caba49b1917818ceaa477e6cc846 (diff)
downloadvolse-hubzilla-1d5ea5efae2262f80c9efb4f6bf0cafbf64f1a4b.tar.gz
volse-hubzilla-1d5ea5efae2262f80c9efb4f6bf0cafbf64f1a4b.tar.bz2
volse-hubzilla-1d5ea5efae2262f80c9efb4f6bf0cafbf64f1a4b.zip
explain the two aspects of federation which need to be handled in core to pass comments successfully amongst sites which optionally provide federation. Let's hope this list doesn't grow.
Diffstat (limited to 'doc')
-rw-r--r--doc/federate.bb7
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/federate.bb b/doc/federate.bb
index 5d253913d..9137ec160 100644
--- a/doc/federate.bb
+++ b/doc/federate.bb
@@ -8,7 +8,7 @@ There are three main components to writing federation plugins. These are:
In addition, federation drivers must handle
-[4] differences in privacy policies
+[4] differences in privacy policies (and content formats)
[h3]Making connections[/h3]
@@ -36,8 +36,11 @@ Additional information that your plugin requires for communication can be stored
When a connection is made, we generally call the notifier (include/notifier.php) to send a message to the remote channel. This is bound to the hook 'permissions_create'. Your plugin will need to handle this in order to send a "follow" or "make friends" message to the other network.
-Note: The first stage zot lookup will be replaced with a webfinger lookup. This work is in progress. A separate lookup was required initially as webfinger does not allow non-SSL connections. We will provide non-SSL zot lookups (usually test and development sites) via the "old" XRD based webfinger to avoid this limitation.
+Notes: The first stage zot lookup will be replaced with a webfinger lookup. This work is in progress. A separate lookup was required initially as webfinger does not allow non-SSL connections. We will provide non-SSL zot lookups (usually test and development sites) via the "old" XRD based webfinger to avoid this limitation.
+The core application will attempt to create xchan records for projects identified as members of the "open web"; currently Hubzilla, Friendica, Diaspora, GNU-Social and Pump.io. This is so that comments can be passed amongst project sites and the network correctly identified. A federation plugin is required to fully federate with other networks, but comments may be passed to sites without such a plugin installed so that there are no unexplained holes in conversations.
+
+The core application must also provide signing ability for Diaspora comments since they require a special signing format and must be signed by the comment author regardless of whether that channel federates with Diaspora. The owner of the conversation may federate with Diaspora so the comments must be signed. This is unfortunate but necessary.
[h3]Sending Messages[/h3]