matrix-org / matrix-org/matrix-spec

room directory does not make it clear how to find a resident server

Open
#1,375 8 comments 1 reaction 0 assignees View on GitHub
clarification
Dominant language
HTML
Stars
330
Forks
150
Avg merge
2h 21m
Merged PRs (30d)
3

Description

**Link to problem area**:

https://spec.matrix.org/v1.5/server-server-api/#get_matrixfederationv1publicrooms
https://spec.matrix.org/v1.5/client-server-api/#get_matrixclientv3publicrooms

**Issue**

Neither the C-S nor federation `/publicRooms` APIs make it clear if servers may return rooms that they are no longer resident in (or cannot handle a join request for some other reason).

If servers *can* return rooms that they are no longer resident in, how is the client supposed to join the room, given there is no server list?

Contributor guide

Open the contributing guide

Research direction

Start with the linked Matrix v1.5 federation and client-server /publicRooms sections. Trace whether a returned room must be resident and how a client can join when no server list is provided; done means the specification states the permitted behavior and join path unambiguously.

Written by the indexing model from the issue text.

Assessment

Domain
api, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.