matrix-org / matrix-org/matrix-spec

Spaces hierarchy lacks a way to know which servers to join via

Open
#2,183 2 comments 0 reactions 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.15/client-server-api/#get_matrixclientv1roomsroomidhierarchy

**Issue**

`SpaceHierarchyRoomsChunk` lacks a `via` key with the servers to join the given room via. This means clients have to use other means to get server names e.g looking at the `sender` key of `children_state` events.

Contributor guide

Open the contributing guide

Research direction

Start with the linked Matrix Client-Server API section for GET /_matrix/client/v1/rooms/{roomId}/hierarchy and inspect the definition of SpaceHierarchyRoomsChunk. Determine how a via server list should be represented for each room, then update the specification so clients can obtain the servers needed to join; done means the response schema and behavior are unambiguous.

Written by the indexing model from the issue text.

Assessment

Domain
api, documentation
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.