matrix-org / matrix-org/matrix-spec

Push rules: 'Rules with the same kind can specify an ordering priority.' but no mention of how this is done

Open
#2,173 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

clarification
Dominant language
HTML
Stars
330
Forks
150
Avg merge
2h 21m
Merged PRs (30d)
3

Description

**Link to problem area**:

**Issue**

This passage claims that rules can specify an ordering priority:

> Rules with the same kind can specify an ordering priority. This determines which rule is selected in the event of multiple matches. For example, a rule matching “tea” and a separate rule matching “time” would both match the sentence “It’s time for tea”. The ordering of the rules would then resolve the tiebreak to determine which rule is executed. Only actions for highest priority rule will be sent to the Push Gateway.

However, looking around, I don't see any field that would specify a priority.
I am not sure if this was true in an earlier specification, proto-specification, implementation or whether it is just an unclear description that there is some priority, given by ordering the rule IDs.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the push-rules section in the Matrix Client-Server API specification at the linked URL. Compare the statement about ordering priority with the rule fields and surrounding definitions, then check whether the specification explains how priority is represented. Done means the specification clearly documents the mechanism or removes the unsupported ambiguity.

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
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.