From 5fdd8010fd2819088c5d358d993d7eb213516e75 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Commaille?= <zecakeh@tedomum.fr>
Date: Fri, 8 May 2026 11:22:14 +0200
Subject: [PATCH] Improve call schemas
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

To look more consistent with other schemas.

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
---
 .../client-server-api/modules/voip_events.md  | 44 ++++++++++++-------
 1 file changed, 28 insertions(+), 16 deletions(-)

diff --git a/content/client-server-api/modules/voip_events.md b/content/client-server-api/modules/voip_events.md
index 27a180c6..775c4f70 100644
--- a/content/client-server-api/modules/voip_events.md
+++ b/content/client-server-api/modules/voip_events.md
@@ -131,27 +131,39 @@ or not there have been any changes to the Matrix spec.
 A call is set up with message events exchanged as follows:
 
 ```nohighlight
-    Caller                    Callee
-    [Place Call]
-    m.call.invite ----------->
-    m.call.candidate -------->
-    [..candidates..] -------->
-                            [Answers call]
-           <--------------- m.call.answer
-    m.call.select_answer ----------->
-     [Call is active and ongoing]
-           <--------------- m.call.hangup
+    +---------+                    +---------+ 
+    | Caller  |                    | Callee  |
+    +---------+                    +---------+
+         |                              |
+   (Places Call)                        |
+         |------- m.call.invite ------->|
+         |----- m.call.candidate ------>|
+         |----- [..candidates..] ------>|
+         |                              |
+         |                        (Answers call)
+         |<------ m.call.answer --------|
+         |---  m.call.select_answer --->|
+         .                              .
+         . (Call is active and ongoing) .
+         .                              .
+         |                         (Ends call)
+         |<------ m.call.hangup --------|
 ```
 
 Or a rejected call:
 
 ```nohighlight
-    Caller                      Callee
-    m.call.invite ------------>
-    m.call.candidate --------->
-    [..candidates..] --------->
-                             [Rejects call]
-             <-------------- m.call.hangup
+    +---------+                    +---------+ 
+    | Caller  |                    | Callee  |
+    +---------+                    +---------+
+         |                              |
+   (Places Call)                        |
+         |------- m.call.invite ------->|
+         |----- m.call.candidate ------>|
+         |----- [..candidates..] ------>|
+         |                              |
+         |                       (Rejects call)
+         |<------ m.call.reject --------|
 ```
 
 Calls are negotiated according to the WebRTC specification.