Describe behaviour when the topic key is falsey in a m.room.topic event.
#2068
Conversation
…vent. We seem to have [updated this for m.room.name](matrix-org#1639) some years back but omitted it for topic.
Half-Shot
changed the title
topic key is falsey in a m.room.topic e…topic key is falsey in a m.room.topic event.
Half-Shot
changed the title
topic key is falsey in a m.room.topic event.topic key is falsey in a m.room.topic event.
| The room topic can also be set when creating a room using `/createRoom` with the `topic` key.' | ||
|
|
||
| If a room has an `m.room.topic` event with an absent, null, or empty `topic` | ||
| field, it should be treated the same as a room with no `m.room.topic` event. |
There was a problem hiding this comment.
While it's a great clarification in itself, it would be even greater to further clarify what happens when an event with an absent/null/empty topic comes upon a previous event with non-falsey topic. I guess the room topic should be reset to the as-if-no-topic state?
There was a problem hiding this comment.
Hm, I suppose I thought that was the implication as with the m.room.name description => clients should use the latest state to render the room, and this description tells clients to assume the topic isn't set.
I'm struggling to find words that doesn't sound a bit repetitive?
There was a problem hiding this comment.
"In other words, an empty topic property effectively resets the room to having no topic."
There was a problem hiding this comment.
Also, https://github.com/matrix-org/matrix-spec/blob/main/meta/documentation_style.rst#general:
prefer the word "property" to "field", "member", or various other alternatives
| field, it should be treated the same as a room with no `m.room.topic` event. | |
| property, it should be treated the same as a room with no `m.room.topic` event. | |
| In other words, sending an `m.room.topic` event with an empty `topic` effectively | |
| resets the room to having no topic. |
| The room topic can also be set when creating a room using `/createRoom` with the `topic` key.' | ||
|
|
||
| If a room has an `m.room.topic` event with an absent, null, or empty `topic` | ||
| field, it should be treated the same as a room with no `m.room.topic` event. |
There was a problem hiding this comment.
"In other words, an empty topic property effectively resets the room to having no topic."
| The room topic can also be set when creating a room using `/createRoom` with the `topic` key.' | ||
|
|
||
| If a room has an `m.room.topic` event with an absent, null, or empty `topic` | ||
| field, it should be treated the same as a room with no `m.room.topic` event. |
There was a problem hiding this comment.
Also, https://github.com/matrix-org/matrix-spec/blob/main/meta/documentation_style.rst#general:
prefer the word "property" to "field", "member", or various other alternatives
| field, it should be treated the same as a room with no `m.room.topic` event. | |
| property, it should be treated the same as a room with no `m.room.topic` event. | |
| In other words, sending an `m.room.topic` event with an empty `topic` effectively | |
| resets the room to having no topic. |
… event. (matrix-org#2068) We seem to have [updated this for m.room.name](matrix-org#1639) some years back but omitted it for topic.
We seem to have updated this for m.room.name some years back but omitted it for topic.
Signed-off-by: Half-Shot [email protected]
Pull Request Checklist
Preview: https://pr2068--matrix-spec-previews.netlify.app