summary refs log tree commit diff
path: root/docs/specification.rst
diff options
context:
space:
mode:
authorPaul "LeoNerd" Evans <paul@matrix.org>2014-10-01 18:34:00 +0100
committerPaul "LeoNerd" Evans <paul@matrix.org>2014-10-01 18:34:08 +0100
commitee447abcad251cd499a9752d3dbdda004c940298 (patch)
tree274d39a3c54e5589513edf898ed23febbabc0f1a /docs/specification.rst
parentSPEC-25: Add details on how to prune redacted events. (diff)
downloadsynapse-ee447abcad251cd499a9752d3dbdda004c940298.tar.xz
Continue moving content out of docs/model/presence into the main spec; delete model docs that are duplicated
Diffstat (limited to 'docs/specification.rst')
-rw-r--r--docs/specification.rst14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/specification.rst b/docs/specification.rst
index 22c55ad861..ada40bdbe3 100644
--- a/docs/specification.rst
+++ b/docs/specification.rst
@@ -1527,6 +1527,15 @@ in the other direction will not). This timestamp is presented via a key called
 ``last_active_ago``, which gives the relative number of miliseconds since the
 message is generated/emitted, that the user was last seen active.
 
+Home servers can also use the user's choice of presence state as a signal for
+how to handle new private one-to-one chat message requests. For example, it
+might decide:
+
+  - ``free_for_chat`` : accept anything
+  - ``online`` : accept from anyone in my addres book list
+  - ``busy`` : accept from anyone in this "important people" group in my
+    address book list
+
 Transmission
 ------------
 .. NOTE::
@@ -1545,6 +1554,11 @@ granted, both user's HS(es) store this information. Since such subscriptions
 are likely to be bidirectional, HSes may wish to automatically accept requests
 when a reverse subscription already exists.
 
+As a convenience, presence lists should support the ability to collect users
+into groups, which could allow things like inviting the entire group to a new
+("ad-hoc") chat room, or easy interaction with the profile information ACL
+implementation of the HS.
+
 Presence and Permissions
 ------------------------
 For a viewing user to be allowed to see the presence information of a target