From 56f878842cdbf7295cdb771ce9c04cc9e9c722de Mon Sep 17 00:00:00 2001 From: Richard van der Hoff Date: Sun, 10 Dec 2017 23:05:55 +0000 Subject: [PATCH] Add a warning that state resolution has problems --- specification/server_server_api.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/specification/server_server_api.rst b/specification/server_server_api.rst index ab40c8a8..e75bf372 100644 --- a/specification/server_server_api.rst +++ b/specification/server_server_api.rst @@ -674,6 +674,11 @@ the room state at a given point on the DAG. State resolution algorithm ~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. WARNING:: + This section documents the state resolution algorithm as implemented by + Synapse as of December 2017 (and therefore the de-facto Matrix protocol). + However, this algorithm is known to have some problems. + The room state :math:`S'(E)` after an event :math:`E` is defined in terms of the room state :math:`S(E)` before :math:`E`, and depends on whether :math:`E` is a state event or a message event: