synapse/docs/development
Eric Eastwood 11db575218
Sliding Sync: Use stream_ordering based timeline pagination for incremental sync (#17510)
Use `stream_ordering` based `timeline` pagination for incremental
`/sync` in Sliding Sync. Previously, we were always using a
`topological_ordering` but we should only be using that for historical
scenarios (initial `/sync`, newly joined, or haven't sent the room down
the connection before).

This is slightly different than what the [spec
suggests](https://spec.matrix.org/v1.10/client-server-api/#syncing)

> Events are ordered in this API according to the arrival time of the
event on the homeserver. This can conflict with other APIs which order
events based on their partial ordering in the event graph. This can
result in duplicate events being received (once per distinct API
called). Clients SHOULD de-duplicate events based on the event ID when
this happens.

But we've had a [discussion below in this
PR](https://github.com/element-hq/synapse/pull/17510#discussion_r1699105569)
and this matches what Sync v2 already does and seems like it makes
sense. Created a spec issue
https://github.com/matrix-org/matrix-spec/issues/1917 to clarify this.

Related issues:

 - https://github.com/matrix-org/matrix-spec/issues/1917
 - https://github.com/matrix-org/matrix-spec/issues/852
 - https://github.com/matrix-org/matrix-spec-proposals/pull/4033
2024-08-07 11:27:50 -05:00
..
img/git Move dev/ docs to development/ (#10453) 2021-07-22 12:58:24 +02:00
internal_documentation Compile and render Synapse's docs into a browsable, mobile-friendly and searchable website (#10086) 2021-06-03 17:20:40 +01:00
synapse_architecture Fix typo 2023-12-13 16:37:10 +00:00
cas.md Improve code formatting and fix a few typos in docs (#11221) 2021-11-01 11:35:55 +00:00
contributing_guide.md Changelog entries only get merged if they have the same content and extension (#17399) 2024-07-04 17:21:25 +01:00
database_schema.md Add documentation on background updates. (#16420) 2023-10-06 07:23:20 -04:00
demo.md Update book location 2023-12-13 16:15:22 +00:00
dependencies.md Update documentation to refer to element-hq. 2023-12-13 15:16:48 +00:00
experimental_features.md Add documentation for experimental feature flags. (#10865) 2021-09-22 13:41:42 +00:00
git.md Fix typo 2023-12-13 16:37:10 +00:00
releases.md Update URLs to matrix.org blog categories. (#16008) 2023-08-24 11:06:06 -04:00
reviews.md Add information on how the Synapse team does reviews. (#13132) 2022-07-06 07:30:58 -04:00
room-dag-concepts.md Sliding Sync: Use stream_ordering based timeline pagination for incremental sync (#17510) 2024-08-07 11:27:50 -05:00
saml.md Improve code formatting and fix a few typos in docs (#11221) 2021-11-01 11:35:55 +00:00