From 9c4d57e91c658b8b7cc6a1c00a5631954fb44b8c Mon Sep 17 00:00:00 2001 From: Travis Ralston Date: Thu, 13 Jan 2022 09:56:38 -0700 Subject: [PATCH] Documentation for extensible events labs flag (#20405) * Documentation for extensible events labs flag * Fix git protocol usage Prevents this: ``` + git clone git://github.com/matrix-org/matrix-js-sdk.git matrix-js-sdk --branch develop --depth 1 Cloning into 'matrix-js-sdk'... fatal: remote error: The unauthenticated git protocol on port 9418 is no longer supported. Please see https://github.blog/2021-09-01-improving-git-protocol-security-github/ for more information. ``` --- docs/labs.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/labs.md b/docs/labs.md index cf6240ce8f..dc28441c8e 100644 --- a/docs/labs.md +++ b/docs/labs.md @@ -165,3 +165,19 @@ triggered by the button to the right of the filter field. ## Spotlight search (`feature_spotlight`) [In Development] Switches to a new room search experience. + +## Extensible events rendering (`feature_extensible_events`) [In Development] + +*Intended for developer use only at the moment.* + +Extensible Events are a [new event format](https://github.com/matrix-org/matrix-doc/pull/1767) which +supports graceful fallback in unknown event types. Instead of rendering nothing or a blank space, events +can define a series of other events which represent the event's information but in different ways. The +base of these fallbacks being text. + +Turning this flag on indicates that, when possible, the extensible events structure should be parsed on +supported event types. This should lead to zero perceptual change in the timeline except in cases where +the sender is using unknown/unrecognised event types. + +Sending events with extensible events structure is always enabled - this should not affect any downstream +client.