From 4e1b364015280f1f5e3d79c5a420d4800ccba04f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?K=C3=A9vin=20Commaille?= <76261501+zecakeh@users.noreply.github.com> Date: Sun, 3 Mar 2024 01:11:05 +0100 Subject: [PATCH] Document the deprecation policy of HTML tags. (#1732) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Deprecate `strike` HTML tag Replace it with `s` or `del`. Signed-off-by: Kévin Commaille * Add changelog Signed-off-by: Kévin Commaille * Remove strike deprecation and add added-in annotation Signed-off-by: Kévin Commaille * Add link to HTML standard Co-authored-by: Hubert Chathi * Update changelogs/client_server/newsfragments/1732.clarification --------- Signed-off-by: Kévin Commaille Co-authored-by: Hubert Chathi Co-authored-by: Travis Ralston --- changelogs/client_server/newsfragments/1732.clarification | 1 + content/client-server-api/modules/instant_messaging.md | 7 +++++++ 2 files changed, 8 insertions(+) create mode 100644 changelogs/client_server/newsfragments/1732.clarification diff --git a/changelogs/client_server/newsfragments/1732.clarification b/changelogs/client_server/newsfragments/1732.clarification new file mode 100644 index 00000000..61e74c6c --- /dev/null +++ b/changelogs/client_server/newsfragments/1732.clarification @@ -0,0 +1 @@ +Document the deprecation policy of HTML tags, as per [MSC4077](https://github.com/matrix-org/matrix-spec-proposals/pull/4077). \ No newline at end of file diff --git a/content/client-server-api/modules/instant_messaging.md b/content/client-server-api/modules/instant_messaging.md index 8a63dd9e..fd05b74b 100644 --- a/content/client-server-api/modules/instant_messaging.md +++ b/content/client-server-api/modules/instant_messaging.md @@ -48,6 +48,13 @@ tags to permit, denying the use and rendering of anything else, is: `s`, `code`, `hr`, `br`, `div`, `table`, `thead`, `tbody`, `tr`, `th`, `td`, `caption`, `pre`, `span`, `img`, `details`, `summary`. +{{% boxes/note %}} +{{% added-in v="1.10" %}} +HTML features MAY be deprecated and replaced by their modern equivalent without +requiring a [Spec Change Proposal](/proposals) when they are deprecated in the +[WHATWG HTML Living Standard](https://html.spec.whatwg.org/multipage/). +{{% /boxes/note %}} + Not all attributes on those tags should be permitted as they may be avenues for other disruption attempts, such as adding `onclick` handlers or excessively large text. Clients should only permit the attributes