Update beta documentation (#32757)

* Add missing feature_notification_settings2

* Update beta docs with stronger restrictions

* a note

* Update betas.md

* Update betas.md
This commit is contained in:
Will Hunt 2026-03-16 09:53:34 +00:00 committed by GitHub
parent d791e3fe8a
commit b54e4e3b98
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 42 additions and 8 deletions

View File

@ -1,14 +1,41 @@
# Beta features
# Beta Features
Beta features are features that are not ready for production yet but the team
wants more people to try the features and give feedback on them.
A feature is marked as beta when it is nearly ready for production and the
team would like to gather wider feedback before turning it on by default.
Before a feature gets into its beta phase, it is often a labs feature (see
[Labs](https://github.com/element-hq/element-web/blob/develop/docs/labs.md)).
Betas are visible to all users, [**including** users who have disabled labs settings
tab](./config.md)
**Be warned! Beta features may not be completely finalised or stable!**
**Be warned! Beta features are not considered stable and should not be relied upon!**
## Video rooms (`feature_video_rooms`)
## Requirements
A beta feature MUST first become a labs feature before it can become a beta (see
[Labs](./labs.md)).
A beta feature MUST have an expected timeline to be upgraded to a stable feature. This timeline
should not exceed 3 months. If a feature persists in beta for longer and hasn't been explicitly
extended, the feature MAY be backed out to labs.
A beta feature SHOULD have a rollback path for users to opt-out. If a feature is irreversible or
could corrupt a user's session or account, it should not be in beta. If this is not possible, it
MUST be discussed with the team first to devise an alternative strategy.
A beta feature SHOULD have analytics so that the team can understand how many users
are using it.
## Current Betas
This is the current set of betas enabled in Element Web.
### Video rooms (`feature_video_rooms`)
Enables support for creating and joining video rooms, which are persistent video
chats that users can jump in and out of.
### New notifications settings (`feature_notification_settings2`) [Beta]
Replaces the legacy notification settings with a new one to manage push rules.
**Warning** This feature has options which are not backwards compatible, disabling
it may have unintended consequences.

View File

@ -76,7 +76,7 @@ For some sample themes, check out [aaronraimist/element-themes](https://github.c
Enables sharing your current location to the timeline, with live updates.
## Video rooms (`feature_video_rooms`)
## Video rooms (`feature_video_rooms`) [Beta]
Enables support for creating video rooms, which are persistent video chats that users can jump in and out of.
@ -134,3 +134,10 @@ Encrypt most of the state events in the room, including the room name and topic.
WARNING: this means that users joining a room who do not have access to its history will not be able to see the name or
topic of the room, or any other room state information. It also means the room name and topic are not available before
joining a room.
## New notifications settings (`feature_notification_settings2`) [Beta]
Replaces the legacy notification settings with a new one to manage push rules.
**Warning** This feature has options which are not backwards compatible, disabling
it may have unintended consequences.