From 1c361a8092691f30a612f85afb17993ed8923202 Mon Sep 17 00:00:00 2001
From: Hans van Zijst <hans@procolix.com>
Date: Wed, 8 Jan 2025 15:45:09 +0100
Subject: [PATCH] Added a few .well-known examples.

---
 matrix/element-call/README.md          |  2 +-
 matrix/element-call/element.json       |  6 ++++++
 matrix/synapse/README.md               |  6 +++++-
 matrix/synapse/well-known-client.json  | 12 ++++++++++++
 matrix/synapse/well-known-server.json  |  1 +
 matrix/synapse/well-known-support.json | 17 +++++++++++++++++
 6 files changed, 42 insertions(+), 2 deletions(-)
 create mode 100644 matrix/element-call/element.json
 create mode 100644 matrix/synapse/well-known-client.json
 create mode 100644 matrix/synapse/well-known-server.json
 create mode 100644 matrix/synapse/well-known-support.json

diff --git a/matrix/element-call/README.md b/matrix/element-call/README.md
index 8ccf5ce..43d0e5f 100644
--- a/matrix/element-call/README.md
+++ b/matrix/element-call/README.md
@@ -363,7 +363,7 @@ necessary:
 
 Now tell the clients about this widget.  Create
 `.well-known/element/element.json`, which is opened by Element Web, Element Desktop
-and ElementX to find the Element Call widget. It should this:
+and ElementX to find the Element Call widget. It should look this:
 
 ```
 {
diff --git a/matrix/element-call/element.json b/matrix/element-call/element.json
new file mode 100644
index 0000000..7885725
--- /dev/null
+++ b/matrix/element-call/element.json
@@ -0,0 +1,6 @@
+{
+    "call":
+    {
+        "widget_url": "https://call.example.com"
+    }
+}
diff --git a/matrix/synapse/README.md b/matrix/synapse/README.md
index c93f3fe..bd9c6f7 100644
--- a/matrix/synapse/README.md
+++ b/matrix/synapse/README.md
@@ -180,7 +180,11 @@ Pointing clients to the correct server needs this at
 Very important: both names (example.com and matrix.example.com) must be A
 and/or AAAA records in DNS, not CNAME.
 
-See [nginx](../nginx) for details about how to publish this data.
+You can also publish support data: administrator, security officer, helpdesk
+page. Publish that as `.well-known/matrix/support`.
+
+See the included files for more elaborate examples, and check
+[nginx](../nginx) for details about how to publish this data.
 
 
 # E-mail {#Email}
diff --git a/matrix/synapse/well-known-client.json b/matrix/synapse/well-known-client.json
new file mode 100644
index 0000000..28a67db
--- /dev/null
+++ b/matrix/synapse/well-known-client.json
@@ -0,0 +1,12 @@
+{
+    "m.homeserver": {
+        "base_url": "https://matrix.example.com"
+    },
+
+    "org.matrix.msc4143.rtc_foci":[
+        {
+            "type": "livekit",
+            "livekit_service_url": "https://livekit.example.com"
+        }
+    ]
+}
diff --git a/matrix/synapse/well-known-server.json b/matrix/synapse/well-known-server.json
new file mode 100644
index 0000000..b9ffd99
--- /dev/null
+++ b/matrix/synapse/well-known-server.json
@@ -0,0 +1 @@
+{"m.server": "matrix.example.com"}
diff --git a/matrix/synapse/well-known-support.json b/matrix/synapse/well-known-support.json
new file mode 100644
index 0000000..ef9be1a
--- /dev/null
+++ b/matrix/synapse/well-known-support.json
@@ -0,0 +1,17 @@
+{
+    "contacts": [
+        {
+            "email_address": "admin@example.com",
+            "matrix_id": "@john:example.com",
+            "role": "m.role.admin"
+	},
+
+        {
+            "email_address": "security@example.com",
+            "matrix_id": "@bob:example.com",
+            "role": "m.role.security"
+        }
+    ],
+
+    "support_page": "https://support.example.com/"
+}