matrix-org / matrix-org/matrix-spec

Server discovery step 3 is incredibly long

Open
#1,565 0 comments 0 reactions 0 assignees View on GitHub
A-S2S 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.7/server-server-api/#resolving-server-names

**Issue**
All of the caching details should be moved to the schema definition. Also, we say *twice* in the same step that "schema details are defined later in this section".

Contributor guide

Open the contributing guide

Research direction

Start with the Resolving server names section linked in the issue, focusing on server discovery step 3 and the schema definition later in that section. Move the caching details to the schema definition and remove the duplicated statement about schema details; the section should retain the same meaning without repeating that note.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.