matrix-org / matrix-org/matrix-spec
Server discovery step 3 is incredibly long
Open
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
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