diff --git a/content/client-server-api/modules/push.md b/content/client-server-api/modules/push.md index 73fc3b2e..0ad035db 100644 --- a/content/client-server-api/modules/push.md +++ b/content/client-server-api/modules/push.md @@ -112,7 +112,7 @@ be marked as read. Note that users can send both an `m.read` and If the user has both `m.read` and `m.read.private` set in the room then the receipt which is more recent/ahead must be used to determine where -the user has read up to. For example, given an ordered set of events A, +the user has read up to. For example, given an oldest-first set of events A, B, C, and D the `m.read` receipt could be at event C and `m.read.private` at event A - the user is considered to have read up to event C. If the `m.read.private` receipt is then updated to point to B or C, the user's diff --git a/content/client-server-api/modules/receipts.md b/content/client-server-api/modules/receipts.md index 75e87ae3..9f80ff60 100644 --- a/content/client-server-api/modules/receipts.md +++ b/content/client-server-api/modules/receipts.md @@ -10,7 +10,7 @@ This module adds in support for receipts. These receipts are a form of acknowledgement of an event. This module defines the `m.read` receipt for indicating that the user has read up to a given event, and `m.read.private` to achieve the same purpose without any other user being aware. Primarily, -`m.read.private` is meant to clear [notifications](#receiving-notifications) +`m.read.private` is intended to clear [notifications](#receiving-notifications) without advertising read-up-to status to others. Sending a receipt for each event can result in sending large amounts of @@ -67,7 +67,7 @@ following HTTP APIs. {{% added-in v="1.4" %}} -Some users would like to clear their [notification counts](#receiving-notifications), +Some users would like to mark a room as read, clearing their [notification counts](#receiving-notifications), but not give away the fact that they've read a particular message yet. To achieve this, clients can send `m.read.private` receipts instead of `m.read` to do exactly that: clear notifications and not broadcast the receipt to