@@ -76,3 +76,34 @@ While this MSC is not considered stable, implementations should use
76
76
| ------------| -------------------------------|
77
77
| ` room_type ` | ` org.matrix.msc3827.room_type ` |
78
78
| ` 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