mirror of
https://github.com/matrix-org/matrix-spec
synced 2025-12-20 16:38:37 +01:00
Clarify that clients should replace events with the most recent replacement by origin_server_ts (#2190)
Some checks failed
Spec / 🔎 Validate OpenAPI specifications (push) Has been cancelled
Spec / 🔎 Check Event schema examples (push) Has been cancelled
Spec / 🔎 Check OpenAPI definitions examples (push) Has been cancelled
Spec / 🔎 Check JSON Schemas inline examples (push) Has been cancelled
Spec / ⚙️ Calculate baseURL for later jobs (push) Has been cancelled
Spec / 📢 Run towncrier for changelog (push) Has been cancelled
Spell Check / Spell Check with Typos (push) Has been cancelled
Spec / 🐍 Build OpenAPI definitions (push) Has been cancelled
Spec / 📖 Build the spec (push) Has been cancelled
Spec / 🔎 Validate generated HTML (push) Has been cancelled
Spec / 📖 Build the historical backup spec (push) Has been cancelled
Some checks failed
Spec / 🔎 Validate OpenAPI specifications (push) Has been cancelled
Spec / 🔎 Check Event schema examples (push) Has been cancelled
Spec / 🔎 Check OpenAPI definitions examples (push) Has been cancelled
Spec / 🔎 Check JSON Schemas inline examples (push) Has been cancelled
Spec / ⚙️ Calculate baseURL for later jobs (push) Has been cancelled
Spec / 📢 Run towncrier for changelog (push) Has been cancelled
Spell Check / Spell Check with Typos (push) Has been cancelled
Spec / 🐍 Build OpenAPI definitions (push) Has been cancelled
Spec / 📖 Build the spec (push) Has been cancelled
Spec / 🔎 Validate generated HTML (push) Has been cancelled
Spec / 📖 Build the historical backup spec (push) Has been cancelled
Signed-off-by: Andy Balaam <andy.balaam@matrix.org>
This commit is contained in:
parent
9c313b099f
commit
f6d5009959
1
changelogs/internal/newsfragments/2190.clarification
Normal file
1
changelogs/internal/newsfragments/2190.clarification
Normal file
|
|
@ -0,0 +1 @@
|
||||||
|
Clarify that clients should replace events with the most recent replacement by origin_server_ts.
|
||||||
|
|
@ -195,7 +195,7 @@ given event (for example, if an event is edited multiple times). These should
|
||||||
be [aggregated](#aggregations-of-child-events) by the homeserver.
|
be [aggregated](#aggregations-of-child-events) by the homeserver.
|
||||||
|
|
||||||
The aggregation format of `m.replace` relationships gives the **most recent**
|
The aggregation format of `m.replace` relationships gives the **most recent**
|
||||||
replacement event, formatted [as normal](#room-event-format).
|
valid replacement event, formatted [as normal](#room-event-format).
|
||||||
|
|
||||||
The most recent event is determined by comparing `origin_server_ts`; if two or
|
The most recent event is determined by comparing `origin_server_ts`; if two or
|
||||||
more replacement events have identical `origin_server_ts`, the event with the
|
more replacement events have identical `origin_server_ts`, the event with the
|
||||||
|
|
@ -268,6 +268,11 @@ Client authors are reminded to take note of the requirements for [Validity of
|
||||||
replacement events](#validity-of-replacement-events), and to ignore any
|
replacement events](#validity-of-replacement-events), and to ignore any
|
||||||
invalid replacement events that are received.
|
invalid replacement events that are received.
|
||||||
|
|
||||||
|
Clients should render the content of the **most recent** valid replacement event. The
|
||||||
|
most recent event is determined by comparing `origin_server_ts`; if two or more
|
||||||
|
replacement events have identical `origin_server_ts`, the event with the
|
||||||
|
lexicographically largest `event_id` is treated as more recent.
|
||||||
|
|
||||||
##### Permalinks
|
##### Permalinks
|
||||||
|
|
||||||
When creating [links](/appendices/#uris) to events (also known as permalinks),
|
When creating [links](/appendices/#uris) to events (also known as permalinks),
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue