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

Tweak PDU diagram demonstrating prev_events. (#3340)

Browse source 
This tweaks the DAG to be simpler, with two linear event chains E4 -> E3
-> E2 -> E1 and E6 -> E5 -> E2 -> E1. The extremities of the DAG are now
the first and only point in the DAG where multiple event parents occur.
Since the point of the diagram is to demonstrate this very situation,
it's better didactically if there is only one such situation in the
diagram.
This commit is contained in:
Denis Kasak 2021-08-31 15:50:38 +00:00 • committed by Richard van der Hoff
parent d9dd37de0c
commit ed08c1cb9e
2 changed files with 7 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

1
changelogs/server_server/newsfragments/3340.clarification Normal file
View file

@ -0,0 +1 @@
Tweak the example PDU diagram to better demonstrate situations with multiple `prev_events`.

11
content/server-server-api.md
View file

@ -333,15 +333,16 @@ after all other known events.
For example, consider a room whose events form the DAG shown below. A For example, consider a room whose events form the DAG shown below. A
server creating a new event in this room should populate the new event's server creating a new event in this room should populate the new event's
`prev_events` field with `E4` and `E5`, since neither event yet has a `prev_events` field with both `E4` and `E6`, since neither event yet has
child: a child:
E1 E1
^ ^
| |
+-> E2 <-+ E2 <--- E5
| | ^ ^
E3 E5 | |
E3 E6
^ ^
| |
E4 E4