From 54d9f888084a003c8b7278c97483107e9c80ddd1 Mon Sep 17 00:00:00 2001
From: Mikaela Suomalainen <mikaela+git@mikaela.info>
Date: Mon, 18 Oct 2021 19:12:49 +0300
Subject: [PATCH] matrix: m.room.join_rules

---
 matrix/m.room.join_rules/README.md | 49 ++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 matrix/m.room.join_rules/README.md

diff --git a/matrix/m.room.join_rules/README.md b/matrix/m.room.join_rules/README.md
new file mode 100644
index 0000000..9f7570c
--- /dev/null
+++ b/matrix/m.room.join_rules/README.md
@@ -0,0 +1,49 @@
+# m.room.join_rules
+
+Controls who can join the room. This is best to configure in room settings.
+
+## knocking
+
+Requires room version 7
+
+```json
+{
+	"join_rule": "knock"
+}
+```
+
+## membership of another room
+
+Requires room version <del>8</del> 9. Offers only Spaces in room settings
+
+```json
+{
+	"allow": [
+		{
+			"room_id": "!oHIvaRnuEEIDavQVRJ:matrix.org",
+			"type": "m.room_membership"
+		}
+	],
+	"join_rule": "restricted"
+}
+```
+
+### membership of one of multiple rooms
+
+```json
+{
+	"allow": [
+		{
+			"room_id": "!psumPMeAfzgAeQpXMG:feneas.org",
+			"type": "m.room_membership"
+		},
+		{
+			"room_id": "!ddFNqIRUacwdicInJz:feneas.org",
+			"type": "m.room_membership"
+		}
+	],
+	"join_rule": "restricted"
+}
+```
+
+It can be presumed that multiple spaces is simply copying that more.