matrix-org / matrix-org/matrix-spec

Unclear override semantics for `power_level_content_override`

Open
#492 4 comments 5 reactions 0 assignees View on GitHub
A-Client-Server clarification
Dominant language
HTML
Stars
330
Forks
150
Avg merge
2h 21m
Merged PRs (30d)
3

Description

From [the spec](https://matrix.org/docs/spec/client_server/r0.5.0#post-matrix-client-r0-createroom):

> power_level_content_override: The power level content to override in the default power level event. This object is __applied on top of__ the generated m.room.power_levels event content prior to it being sent to the room. Defaults to overriding nothing.

It's unclear what the exact override semantics are here. Is the entire generated `m.room.power_levels` content discarded and replaced with the object specified here (ie. potentially removing keys)? Are they deep-merged? If yes, what are the exact merge semantics?

Contributor guide

Open the contributing guide

Research direction

Start with the linked Matrix Client-Server r0.5.0 create-room specification section and the definition of power_level_content_override. Determine whether the override replaces the generated content or is merged, including exact handling of nested keys. Done means the specification clearly documents the chosen semantics.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.