From 5e938f2b839caaef1e68b598e65c23ceccc1b4f1 Mon Sep 17 00:00:00 2001
From: Patrick Cloke <clokep@users.noreply.github.com>
Date: Tue, 5 Sep 2023 09:38:05 -0400
Subject: [PATCH] Document .m.rule.suppress_edits push rule (MSC3958). (#1617)

---
 .../client_server/newsfragments/1617.feature  |  1 +
 content/client-server-api/modules/push.md     | 24 +++++++++++++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 changelogs/client_server/newsfragments/1617.feature

diff --git a/changelogs/client_server/newsfragments/1617.feature b/changelogs/client_server/newsfragments/1617.feature
new file mode 100644
index 00000000..78f112e0
--- /dev/null
+++ b/changelogs/client_server/newsfragments/1617.feature
@@ -0,0 +1 @@
+Add the `m.rule.suppress_edits` default push rule from [MSC3958](https://github.com/matrix-org/matrix-spec-proposals/pull/3958).
diff --git a/content/client-server-api/modules/push.md b/content/client-server-api/modules/push.md
index d1855f58..23222ada 100644
--- a/content/client-server-api/modules/push.md
+++ b/content/client-server-api/modules/push.md
@@ -750,6 +750,30 @@ Definition:
 }
 ```
 
+**`.m.rule.suppress_edits`**
+
+{{% added-in v="1.9" %}}
+
+Suppresses notifications related to [event replacements](#event-replacements).
+
+Definition:
+
+```json
+{
+    "rule_id": ".m.rule.suppress_edits",
+    "default": true,
+    "enabled": true,
+    "conditions": [
+        {
+            "kind": "event_property_is",
+            "key": "content.m\\.relates_to.rel_type",
+            "value": "m.replace"
+        }
+    ],
+    "actions": []
+}
+```
+
 ##### Default Content Rules
 
 <a id="_m_rule_contains_user_name"/> **`.m.rule.contains_user_name`**