improve documentation of ephemeral events (#1284)

This commit is contained in:
Hubert Chathi 2022-11-17 02:53:15 -05:00 committed by GitHub
parent 64922771d4
commit 2fcc92c2fb
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 9 additions and 5 deletions

View file

@ -0,0 +1 @@
Improve documentation about ephemeral events.

View file

@ -62,8 +62,9 @@ properties:
ephemeral:
allOf:
- $ref: room_event_filter.yaml
description: The events that aren't recorded in the room history, e.g. typing
and receipts, to include for rooms.
description: The ephemeral events to include for rooms. These are the
events that appear in the `ephemeral` property in the `/sync`
response.
include_leave:
description: Include rooms that the user has left in the sync, default false
type: boolean

View file

@ -219,9 +219,11 @@ paths:
title: Ephemeral
type: object
description: |-
The ephemeral events in the room that aren't
recorded in the timeline or state of the room.
e.g. typing.
The new ephemeral events in the room (events that
aren't recorded in the timeline or state of the
room). In this version of the spec, these are
[typing notification](#typing-notifications) and
[read receipt](#receipts) events.
allOf:
- $ref: "definitions/event_batch.yaml"
account_data: