Skip to content

Commit 0f067f1

Browse files
Specify how servers detect support for MSC3827 (#3854)
Signed-off-by: Šimon Brandner <[email protected]>
1 parent 1ec0d58 commit 0f067f1

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

proposals/3827-space-explore.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,3 +76,34 @@ While this MSC is not considered stable, implementations should use
7676
|------------|-------------------------------|
7777
|`room_type` |`org.matrix.msc3827.room_type` |
7878
|`room_types`|`org.matrix.msc3827.room_types`|
79+
80+
Clients should check for server support before using the features proposed by
81+
this MSC.
82+
83+
Once this MSC gets merged and once it becomes a part of a spec version, clients
84+
should update their implementations as fast as possible to accommodate the fact
85+
that the way of detecting server support will change.
86+
87+
### While the MSC is unstable
88+
89+
During this period, to detect server support, clients should check for the
90+
presence of the `org.matrix.msc3827` flag in `unstable_features` on `/versions`.
91+
Clients are also required to use the unstable prefixes (see [unstable
92+
prefix](#unstable-prefix)) during this time.
93+
94+
### Once the MSC is merged but not in a spec version
95+
96+
Once this MSC is merged, but is not yet part of the spec, clients should rely on
97+
the presence of the `org.matrix.msc3827.stable` flag in `unstable_features` to
98+
determine server support. If the flag is present, clients are required to use
99+
stable prefixes (see [unstable prefix](#unstable-prefix)).
100+
101+
### Once the MSC is in a spec version
102+
103+
Once this MSC becomes a part of a spec version, clients should rely on the
104+
presence of the spec version, that supports the MSC, in `versions` on
105+
`/versions`, to determine support. Servers are encouraged to keep the
106+
`org.matrix.msc3827.stable` flag around for a reasonable amount of time to help
107+
smooth over the transition for clients. "Reasonable" is intentionally left as an
108+
implementation detail, however the MSC process currently recommends _at most_ 2
109+
months from the date of spec release.

0 commit comments

Comments
 (0)