Clarify presence router docs.

matrix-org · Oct 20, 2023 · 9284fce · 9284fce
1 parent e9069c9
commit 9284fce
Showing 1 changed file with 9 additions and 3 deletions.
diff --git a/docs/modules/presence_router_callbacks.md b/docs/modules/presence_router_callbacks.md
@@ -1,8 +1,14 @@
 # Presence router callbacks
 
-Presence router callbacks allow module developers to specify additional users (local or remote)
-to receive certain presence updates from local users. Presence router callbacks can be 
-registered using the module API's `register_presence_router_callbacks` method.
+Presence router callbacks allow module developers to define additional users
+which receive updates presence updates from local users. The additional users
+can be local or remote.
+
+For example, it could be used to have `alice` receive all presence updates from
+`bob` even though they don't share a room.
+
+Presence router callbacks can be registered using the module API's
+`register_presence_router_callbacks` method.
 
 ## Callbacks