summary refs log tree commit diff
path: root/docs
diff options
context:
space:
mode:
authorPaul "LeoNerd" Evans <paul@matrix.org>2014-09-01 17:22:33 +0100
committerPaul "LeoNerd" Evans <paul@matrix.org>2014-09-01 17:22:33 +0100
commit32bfd567ac471c8916fe4d1601954448cbb25edb (patch)
tree169612fd5e170c055287cf38cda578475eace370 /docs
parentFairly simple move of the call status widget to the header bar (and therefore... (diff)
downloadsynapse-32bfd567ac471c8916fe4d1601954448cbb25edb.tar.xz
Added docs on presence 'last_active' field
Diffstat (limited to 'docs')
-rw-r--r--docs/specification.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/specification.rst b/docs/specification.rst
index 51c34772ff..5351da9f24 100644
--- a/docs/specification.rst
+++ b/docs/specification.rst
@@ -718,6 +718,14 @@ client devices they have connected. The home server should synchronise this
 status choice among multiple devices to ensure the user gets a consistent
 experience.
 
+In addition, the server maintains a timestamp of the last time it saw an active
+action from the user; either sending a message to a room, or changing presence
+state from a lower to a higher level of availability (thus: changing state from
+``unavailable`` to ``online`` will count as an action for being active, whereas
+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.
+
 Idle Time
 ---------
 As well as the basic ``presence`` field, the presence information can also show