matrix-org / matrix-org/matrix-spec

Clarify how many pushers can be associated with a given access token

Open
#1,222 0 comments 0 reactions 0 assignees View on GitHub
A-Push 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/latest/client-server-api/#push-notifications

**Issue**

The definition of a pusher in that section is fairly confusing and also a bit misleading by saying there can only be "one per device". It is unclear what "device" is referring to here (since Matrix itself has a concept called a "device"). If we're talking about Matrix devices, the restriction that one device can only have one pusher is quite impractical, since it means clients cannot register both an HTTP pusher and an email one. It is also worth noting that Synapse does not enforce any restriction on the number of pushers associated with a given device (and never has as far as I can tell).

Contributor guide

Open the contributing guide

Research direction

Start with the Push Notifications section linked in the issue, especially the definition of a pusher and its statement about one pusher per device. Review how the surrounding specification describes access tokens and Matrix devices. The work is done when the specification clearly explains what “device” means and how many pushers may be associated with an access token or device.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.