matrix-org / matrix-org/matrix-spec

GET /directory/room/:alias should say words about resident servers, not knowledgeable ones

Open
#528 0 comments 0 reactions 0 assignees View on GitHub
A-Client-Server
Dominant language
HTML
Stars
330
Forks
150
Avg merge
2h 21m
Merged PRs (30d)
3

Description

Link: https://spec.matrix.org/v1.13/client-server-api/#get_matrixclientv3directoryroomroomalias

It currently says 'servers that are aware of the room alias': no servers are going to be aware of it except the directory server, the others are meant to resolve it. It should say resident servers instead.

Contributor guide

Open the contributing guide

Research direction

Open the linked Matrix Client-Server API section for GET /_matrix/client/v3/directory/room/{roomAlias} and locate the phrase about servers being aware of the room alias. Update the wording to refer to resident servers, then verify the specification text clearly describes the intended servers.

Written by the indexing model from the issue text.

Assessment

Domain
api, documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.