matrix-org / matrix-org/matrix-spec
Unclear override semantics for `power_level_content_override`
- 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
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