From afc5298f11e0ffa93a8e99839aa15fb80de958fe Mon Sep 17 00:00:00 2001
From: Travis Ralston <travisr@matrix.org>
Date: Wed, 29 Dec 2021 11:58:14 -0700
Subject: [PATCH] Replace s2s join sequence diagram for legibility (#3603)

Without the vertical lines it's a bit difficult to parse. A different tool was used to generate the graph this time.
---
 content/server-server-api.md | 57 ++++++++++++++++++++++++++----------
 1 file changed, 42 insertions(+), 15 deletions(-)

diff --git a/content/server-server-api.md b/content/server-server-api.md
index f916c212..468be249 100644
--- a/content/server-server-api.md
+++ b/content/server-server-api.md
@@ -678,22 +678,49 @@ candidate may be used at each time. Thus, any join handshake can
 potentially involve anywhere from two to four homeservers, though most
 in practice will use just two.
 
+<!--
+https://textart.io/sequence
+
+object Client JoiningServer DirectoryServer ResidentServer
+Client->JoiningServer: join request
+JoiningServer->DirectoryServer: directory request
+DirectoryServer->JoiningServer: directory response
+JoiningServer->ResidentServer: make_join request
+ResidentServer->JoiningServer: make_join response
+JoiningServer->ResidentServer: send_join request
+ResidentServer->JoiningServer: send_join response
+JoiningServer->Client: join response
+-->
+
 ```
-    Client         Joining                Directory       Resident
-                   Server                 Server          Server
-
-    join request -->
-                   |
-                   directory request ------->
-                   <---------- directory response
-                   |
-                   make_join request ----------------------->
-                   <------------------------------- make_join response
-                   |
-                   send_join request ----------------------->
-                   <------------------------------- send_join response
-                   |
-    <---------- join response
++---------+          +---------------+            +-----------------+ +-----------------+
+| Client  |          | JoiningServer |            | DirectoryServer | | ResidentServer  |
++---------+          +---------------+            +-----------------+ +-----------------+
+     |                       |                             |                   |
+     | join request          |                             |                   |
+     |---------------------->|                             |                   |
+     |                       |                             |                   |
+     |                       | directory request           |                   |
+     |                       |---------------------------->|                   |
+     |                       |                             |                   |
+     |                       |          directory response |                   |
+     |                       |<----------------------------|                   |
+     |                       |                             |                   |
+     |                       | make_join request           |                   |
+     |                       |------------------------------------------------>|
+     |                       |                             |                   |
+     |                       |                             |make_join response |
+     |                       |<------------------------------------------------|
+     |                       |                             |                   |
+     |                       | send_join request           |                   |
+     |                       |------------------------------------------------>|
+     |                       |                             |                   |
+     |                       |                             |send_join response |
+     |                       |<------------------------------------------------|
+     |                       |                             |                   |
+     |         join response |                             |                   |
+     |<----------------------|                             |                   |
+     |                       |                             |                   |
 ```
 
 The first part of the handshake usually involves using the directory