Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-02-17 19:43:43 +01:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity

Mention knockable rooms in warning

Browse source
This commit is contained in:
Johannes Marbach 2025-03-20 10:47:51 +01:00
parent 5be34d8f2b
commit 03c96e505b
1 changed files with 10 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
content/client-server-api/_index.md
View file

@ -2848,9 +2848,16 @@ creation, clients can query and change a room's visibility in the directory thro
the endpoints listed below, provided that the server permits this.
{{% boxes/warning %}}
A visibility setting of `public` should not be confused with a `public` [join rule](#mroomjoin_rules)
or a `world_readable` [history visibility](#room-history-visibility). The visibility merely defines
whether a room is included in the published room directory or not.
The visibility setting merely defines whether a room is included in the published
room directory or not. It doesn't make any guarantees about the room's
[join rule](#mroomjoin_rules) or [history visibility](#room-history-visibility).
In particular, a visibility setting of `public` should not be confused with a `public`
join rule. Rooms with a join rule of `knock`, for instance, could reasonably be published
in the directory, too.
Similarly, a visibility setting of `public` does not necessarily imply a `world_readable`
history visibility.
{{% /boxes/warning %}}
{{% http-api spec="client-server" api="list_public_rooms" %}}