Skip to content

Document how read receipts work over federation #1484

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 17, 2018

Conversation

turt2live
Copy link
Member

@turt2live turt2live commented Aug 4, 2018

Rendered: see 'docs' commit status.

This PR is blocked on #1463 as it makes use of the "definitions embedded in the spec" feature, and builds upon EDUs.

Blocked on:


Federation format: https://github.com/matrix-org/synapse/blob/d69decd5c78c72abef50b597a689e2bc55a39702/synapse/handlers/receipts.py#L153-L166

Population of the fields that the above uses to construct the EDU: https://github.com/matrix-org/synapse/blob/d69decd5c78c72abef50b597a689e2bc55a39702/synapse/handlers/receipts.py#L48-L56

@turt2live turt2live added the blocked Something needs to be done before action can be taken on this PR/issue. label Aug 4, 2018
@turt2live turt2live mentioned this pull request Aug 4, 2018
35 tasks
@turt2live turt2live force-pushed the travis/s2s/read-receipts branch from aa60209 to e03bfbc Compare August 8, 2018 14:27
@turt2live turt2live removed the blocked Something needs to be done before action can be taken on this PR/issue. label Aug 8, 2018
@turt2live turt2live requested a review from a team August 8, 2018 14:27
type: array
description: |-
The event ID that the user has read up to. Must be exactly
one element in length.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not really, no. Its the set of extremities that the user has read up to. (I think synapse cheats and mostly does only one entry). This is to support e.g. expressing you have read both sides of a fork.

--------

Receipts are EDUs used to communicate a marker for a given event. Currently the
only kind of receipt supported is a "read receipt", or where in the timeline a
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The timeline isn't a thing as far as federation is concerned, really.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is to try and relate the server-server spec to the client-server things. Suggestions on improved wording would be appreciated.

@turt2live
Copy link
Member Author

@erikjohnston please take another look

@turt2live turt2live merged commit 21dc6f8 into matrix-org:master Aug 17, 2018
@turt2live turt2live deleted the travis/s2s/read-receipts branch August 17, 2018 15:50
RiotTranslateBot pushed a commit to RiotTranslateBot/matrix-doc that referenced this pull request Aug 22, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants