matrix-org / matrix-org/matrix-spec

'Third-party Signed' object does not say who the `signatures` are supposed to be from or why they are there

Open
#1,722 0 comments 0 reactions 0 assignees View on GitHub
A-3PID A-Client-Server 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.9/client-server-api/#post_matrixclientv3joinroomidoralias

**Issue**
The *Third-party Signed* object, used for redeeming a 3PID invite, contains a `signatures` field.
But it doesn't say who the signatures are supposed to be *from*.

It also doesn't say why the signatures are needed, which can help with understanding.

Contributor guide

Open the contributing guide

Research direction

Open the linked Client-Server API section for POST /_matrix/client/v3/join/{roomIdOrAlias} and read the Third-party Signed object definition. Update the specification to state who provides the signatures and why they are required, then confirm both points are clear in that section.

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
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.