add matrix/m.policy.{server,user}/README.md

matrix/m.policy.rule.server/README.md

@@ -0,0 +1,62 @@
+# `m.policy.rule.server`
+
+This event is the language of Draupnir/Mjolnir and experimental Mjolnir style ignore in Element Web labs when speaking of homeservers.
+
+TL;DR
+
+- Event type: `m.policy.rule.server`
+- State key: `example.net` (server name goes here)
+
+<!-- prettier-ignore-start -->
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+- [Allowing all servers](#allowing-all-servers)
+- [Allowing server mjolnir.matrix.org](#allowing-server-mjolnirmatrixorg)
+- [Banning evil example.org](#banning-evil-exampleorg)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+<!-- prettier-ignore-end -->
+
+## Allowing all servers
+
+- Event type: `m.policy.rule.server`
+- State key: `*`
+
+```json
+{
+  "entity": "*",
+  "reason": "Default ACL allow all",
+  "recommendation": "org.matrix.mjolnir.allow"
+}
+```
+
+## Allowing server mjolnir.matrix.org
+
+- Event type: `m.policy.rule.server`
+- State key: `mjolnir.matrix.org`
+
+```json
+{
+  "entity": "mjolnir.matrix.org",
+  "reason": "Mjolnir for all!",
+  "recommendation": "org.matrix.mjolnir.allow"
+}
+```
+
+## Banning evil example.org
+
+_Well, the example organization domain is now evil :smirk_cat:_
+
+- Event type: `m.policy.rule.server`
+- State key: `example.org`
+
+```json
+{
+  "entity": "*",
+  "reason": "Evil example homeserver",
+  "recommendation": "m.ban"
+}
+```

matrix/m.policy.rule.user/README.md

@@ -0,0 +1,32 @@
+# `m.policy.rule.user`
+
+This event is the language of Draupnir/Mjolnir and experimental Mjolnir style ignore in Element Web labs when speaking of individual users.
+
+TL;DR
+
+- Event type: `m.policy.rule.server`
+- State key: `_username:example.net` (The leading`@` is replaced with an underscore `_`)
+
+<!-- prettier-ignore-start -->
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+- [Banning an user](#banning-an-user)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+<!-- prettier-ignore-end -->
+
+## Banning an user
+
+- Event type: `m.policy.rule.user`
+- State key: `_username:example.net`
+
+```json
+{
+  "entity": "@username:example.net",
+  "reason": "Example ban",
+  "recommendation": "m.ban"
+}
+```