Skip to content

Commit

Permalink
Specify how servers detect support for MSC3827 (#3854)
Browse files Browse the repository at this point in the history
Signed-off-by: Šimon Brandner <simon.bra.ag@gmail.com>
  • Loading branch information
SimonBrandner authored Jul 26, 2022
1 parent 1ec0d58 commit 0f067f1
Showing 1 changed file with 31 additions and 0 deletions.
31 changes: 31 additions & 0 deletions proposals/3827-space-explore.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,3 +76,34 @@ While this MSC is not considered stable, implementations should use
|------------|-------------------------------|
|`room_type` |`org.matrix.msc3827.room_type` |
|`room_types`|`org.matrix.msc3827.room_types`|

Clients should check for server support before using the features proposed by
this MSC.

Once this MSC gets merged and once it becomes a part of a spec version, clients
should update their implementations as fast as possible to accommodate the fact
that the way of detecting server support will change.

### While the MSC is unstable

During this period, to detect server support, clients should check for the
presence of the `org.matrix.msc3827` flag in `unstable_features` on `/versions`.
Clients are also required to use the unstable prefixes (see [unstable
prefix](#unstable-prefix)) during this time.

### Once the MSC is merged but not in a spec version

Once this MSC is merged, but is not yet part of the spec, clients should rely on
the presence of the `org.matrix.msc3827.stable` flag in `unstable_features` to
determine server support. If the flag is present, clients are required to use
stable prefixes (see [unstable prefix](#unstable-prefix)).

### Once the MSC is in a spec version

Once this MSC becomes a part of a spec version, clients should rely on the
presence of the spec version, that supports the MSC, in `versions` on
`/versions`, to determine support. Servers are encouraged to keep the
`org.matrix.msc3827.stable` flag around for a reasonable amount of time to help
smooth over the transition for clients. "Reasonable" is intentionally left as an
implementation detail, however the MSC process currently recommends _at most_ 2
months from the date of spec release.

0 comments on commit 0f067f1

Please sign in to comment.