-
Notifications
You must be signed in to change notification settings - Fork 385
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Spec spoilers and color attribute allowance #2549
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I believe we should relax the terms a bit in favour of basic clients. Otherwise LGTM.
The plain text (``body``) fallback for spoilers is a little different than the HTML-formatted | ||
message as the ``body`` is often included as-is in notifications to the user. To prevent spoilers | ||
in notifications and other places, clients are strongly encouraged to first upload the spoiler |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The plain text (``body``) fallback for spoilers is a little different than the HTML-formatted | |
message as the ``body`` is often included as-is in notifications to the user. To prevent spoilers | |
in notifications and other places, clients are strongly encouraged to first upload the spoiler | |
When sending a spoiler, clients SHOULD provide the plain text fallback in ``body``. | |
The fallback SHOULD omit the spoiler text verbatim (but include the reason), since ``body`` | |
contents can be used as-is in basic clients, notifications to the user etc. To prevent spoilers | |
showing up in such situations, clients are strongly encouraged to first upload the spoiler |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The MSC does not make the fallback a SHOULD, anywhere (or I'm failing to see it). The MSC only ever references it as "the plaintext fallback" in a context of SHOULD upload the text, implying that it is required (in terms of language on the page).
To be clear, this concern is about the first SHOULD - the second SHOULD with respect to uploading the files is fine.
I'm happy to block this PR behind another MSC to clarify the intent, as this seems like it could be an opportunity for extended discussion which doesn't belong here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yeah, I agree the original MSC is not perfectly clear on the modality of the fallback (whether it's SHOULD or MUST).
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Soru intended to word it as a recommendation, however if it is ambiguous it seems like further discussion might be appropriate.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Co-authored-by: Kitsune Ral <Kitsune-Ral@users.sf.net>
@@ -499,6 +499,54 @@ the output looks similar to the following:: | |||
For ``m.image``, the text should be ``"sent an image."``. For ``m.video``, the text | |||
should be ``"sent a video."``. For ``m.audio``, the text should be ``"sent an audio file"``. | |||
|
|||
Spoiler messages |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
TODO: Mention that spoilers are only possible on m.room.message
(specifically m.text
) events.
If another MSC does show up, it'd be good to expand this to textual types in general (emotes, notices, etc).
this is unblocked now, but needs to be reviewed for accuracy before going back to general spec review. |
also needs to be ported to the markdown version |
Replaced by #3098 |
Spoilers MSC: #2010
color
attribute MSC: #2422