From 23ab1c527a4864f632ce07d80d80fa23eae81ed6 Mon Sep 17 00:00:00 2001 From: Travis Ralston Date: Sun, 26 May 2019 22:16:12 -0600 Subject: [PATCH 1/4] Clarify how redactions affect room state Fixes https://github.com/matrix-org/matrix-doc/issues/1726 --- .../client_server/newsfragments/2032.clarification | 1 + specification/client_server_api.rst | 9 +++++++++ 2 files changed, 10 insertions(+) create mode 100644 changelogs/client_server/newsfragments/2032.clarification diff --git a/changelogs/client_server/newsfragments/2032.clarification b/changelogs/client_server/newsfragments/2032.clarification new file mode 100644 index 00000000..e497b8be --- /dev/null +++ b/changelogs/client_server/newsfragments/2032.clarification @@ -0,0 +1 @@ +Clarify how redactions affect room state. diff --git a/specification/client_server_api.rst b/specification/client_server_api.rst index 604c2b1c..a254a85d 100644 --- a/specification/client_server_api.rst +++ b/specification/client_server_api.rst @@ -1531,6 +1531,15 @@ property of the redacted event, under the ``redacted_because`` key. When a client receives a redaction event it should change the redacted event in the same way a server does. +.. NOTE:: + + Redacted events can still affect the state of the room. For example, a + redacted ``join`` event will still result in the user being considered + joined. Similarly, a redacted topic does not necessarily cause the topic + to revert to what is was prior to the event - it causes the topic to be + removed from the room. + + Events ++++++ From d14dc1d8e15a12b91cb20592d6e46c6b20ea678a Mon Sep 17 00:00:00 2001 From: Travis Ralston Date: Mon, 27 May 2019 21:15:24 -0600 Subject: [PATCH 2/4] Clarify that redacted state events affect the room with default values --- specification/client_server_api.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/specification/client_server_api.rst b/specification/client_server_api.rst index a254a85d..22cc9425 100644 --- a/specification/client_server_api.rst +++ b/specification/client_server_api.rst @@ -1533,11 +1533,12 @@ same way a server does. .. NOTE:: - Redacted events can still affect the state of the room. For example, a - redacted ``join`` event will still result in the user being considered - joined. Similarly, a redacted topic does not necessarily cause the topic - to revert to what is was prior to the event - it causes the topic to be - removed from the room. + Redacted events can still affect the state of the room. When redacted, + state events behave as though their properties were simply not specified + unless their properties are protected by the redaction algorithm. For example, + a redacted ``join`` event will still result in the user being considered joined. + Similarly, a redacted topic does not necessarily cause the topic to revert to + what is was prior to the event - it causes the topic to be removed from the room. Events From 9acd960cf6afc8ddb011f7db5ca00fbf57cba5a5 Mon Sep 17 00:00:00 2001 From: Travis Ralston Date: Mon, 27 May 2019 21:22:07 -0600 Subject: [PATCH 3/4] Update specification/client_server_api.rst Co-Authored-By: Kitsune Ral --- specification/client_server_api.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/client_server_api.rst b/specification/client_server_api.rst index 22cc9425..c18f4d03 100644 --- a/specification/client_server_api.rst +++ b/specification/client_server_api.rst @@ -1535,7 +1535,7 @@ same way a server does. Redacted events can still affect the state of the room. When redacted, state events behave as though their properties were simply not specified - unless their properties are protected by the redaction algorithm. For example, + except those protected by the redaction algorithm. For example, a redacted ``join`` event will still result in the user being considered joined. Similarly, a redacted topic does not necessarily cause the topic to revert to what is was prior to the event - it causes the topic to be removed from the room. From 8151aa331f6b553ffa755f38aaffb5f5b466b07a Mon Sep 17 00:00:00 2001 From: Travis Ralston Date: Tue, 28 May 2019 12:51:36 -0600 Subject: [PATCH 4/4] Update specification/client_server_api.rst Co-Authored-By: Hubert Chathi --- specification/client_server_api.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/client_server_api.rst b/specification/client_server_api.rst index c18f4d03..a8246578 100644 --- a/specification/client_server_api.rst +++ b/specification/client_server_api.rst @@ -1534,7 +1534,7 @@ same way a server does. .. NOTE:: Redacted events can still affect the state of the room. When redacted, - state events behave as though their properties were simply not specified + state events behave as though their properties were simply not specified, except those protected by the redaction algorithm. For example, a redacted ``join`` event will still result in the user being considered joined. Similarly, a redacted topic does not necessarily cause the topic to revert to