wholetrans/docs-matrix-spec
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Clarify that dont_notify and coalesce MUST be gracefully ignored (#1890)

Browse source
This commit is contained in:
Johannes Marbach 2024-07-10 03:35:57 +02:00 • committed by GitHub
parent 2261c03bcd
commit e4589bbc8a
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 7 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

1
changelogs/client_server/newsfragments/1890.clarification Normal file
View file

@ -0,0 +1 @@
Clarify that the deprecated `dont_notify` and `coalesce` push rule actions MUST be ignored, not rejected.

10
content/client-server-api/modules/push.md
View file

@ -184,11 +184,13 @@ they are represented as a dictionary with a key equal to their name and
other keys as their parameters, e.g.
`{ "set_tweak": "sound", "value": "default" }`.
{{% boxes/note %}}
###### Historical Actions
Older versions of the Matrix specification included the `dont_notify` and
`coalesce` actions. These should both be considered no-ops (ignored, not
rejected) if received from a client.
{{% /boxes/note %}}
`coalesce` actions. Clients and homeservers MUST ignore these actions, for
instance, by stripping them from actions arrays they encounter. This means,
for example, that a rule with `["dont_notify"]` actions MUST be equivalent
to a rule with an empty actions array.
##### Conditions