Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-03-08 12:34:09 +01:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Public rooms directory backwards compatibility note

Browse source
This commit is contained in:
Andrew Morgan 2021-02-09 11:18:55 +00:00
parent 51a7778217
commit 6a0d07c799
1 changed files with 7 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
proposals/2403-knock.md
View file

@ -325,7 +325,7 @@ of these methods for room discovery is the public rooms directory, which
allows us to explore a list of rooms we may be able to join. allows us to explore a list of rooms we may be able to join.
The spec does not prevent us from adding rooms with 'knock' join_rules to the The spec does not prevent us from adding rooms with 'knock' join_rules to the
public rooms directory. However, there is a problem in that a user attempting public rooms directory. However, a user attempting
to join a room in the directory will not know whether to directly attempt a to join a room in the directory will not know whether to directly attempt a
join, or to knock first. The current content of a `PublicRoomsChunk` does not join, or to knock first. The current content of a `PublicRoomsChunk` does not
contain this information: contain this information:
@ -347,10 +347,14 @@ contain this information:
Therefore this proposal adds `join_rule` as a new, required field to a Therefore this proposal adds `join_rule` as a new, required field to a
`PublicRoomsChunk`. The `join_rule` of knockable rooms will be `knock`, thus `PublicRoomsChunk`. The `join_rule` of knockable rooms will be `knock`, thus
giving clients the information they need to know how to attempt entry of giving clients the information they need to attempt entry of
a room when a client selects it, as well as allowing clients to display a room when a client selects it. It also allows clients to display
knockable rooms differently than publicly joinable ones. knockable rooms differently than publicly joinable ones.
For backwards compatibility with old servers, if a client does not find a
`join_rule` key in a chunk, then it should assume a `join_rule` key with
value `public`.
## Server-Server API ## Server-Server API
Similarly to join and leave over federation, a ping-pong game with two new Similarly to join and leave over federation, a ping-pong game with two new