diff --git a/src/SlashCommands.js b/src/SlashCommands.js
index 11018df081..dc653b45ab 100644
--- a/src/SlashCommands.js
+++ b/src/SlashCommands.js
@@ -112,30 +112,59 @@ export const CommandMap = {
title: _t('Room upgrade confirmation'),
description: (
- { _t(
- "Upgrading your room in this way can be dangerous or unnecessary. Room upgrades " +
- "are usually done to change the server's behaviour in a given room and not so much " +
- "anything to do with client (Riot) behaviour.",
- ) }
-
-
- { _t(
- "Members of the room will be required to click a link to join the new room. No " +
- "one will be automatically joined or invited to the new room.",
- ) }
-
-
- { _t(
- "Please confirm that you'd like to go forward with upgrading this room from " +
- "%(oldVersion)s to %(newVersion)s",
- {
- oldVersion: room ? room.getVersion() : "1",
- newVersion: args,
- },
- ) }
+
{_t("Upgrading a room can be destructive and isn't always necessary.")}
+
+ {_t(
+ "Room upgrades are usually recommended when a room version is considered " +
+ "unstable. Unstable room versions might have bugs, missing features, or " +
+ "security vulnerabilities.",
+ {}, {
+ "i": (sub) => {sub},
+ },
+ )}
+
+
+ {_t(
+ "Room upgrades usually only affect server-side processing of the " +
+ "room. If you're having problems with your Riot client, please file an issue " +
+ "with .",
+ {}, {
+ "i": (sub) => {sub},
+ "issueLink": () => {
+ return
+ https://github.com/vector-im/riot-web/issues/new/choose
+ ;
+ },
+ }
+ )}
+
+
+ {_t(
+ "Warning: Upgrading a room will not automatically migrate room " +
+ "members to the new version of the room. We'll post a link to the new room " +
+ "in the old version of the room - room members will have to click this link to " +
+ "join the new room.",
+ {}, {
+ "b": (sub) => {sub},
+ "i": (sub) => {sub},
+ },
+ )}
+
+
+ {_t(
+ "Please confirm that you'd like to go forward with upgrading this room " +
+ "from to ",
+ {},
+ {
+ oldVersion: () => {room ? room.getVersion() : "1"}
,
+ newVersion: () => {args}
,
+ },
+ )}
+
),
- button: _t("Upgrade Room"),
+ button: _t("Upgrade"),
onFinished: (confirm) => {
if (!confirm) return;
diff --git a/src/i18n/strings/en_EN.json b/src/i18n/strings/en_EN.json
index 976f902f27..ef4bc75d27 100644
--- a/src/i18n/strings/en_EN.json
+++ b/src/i18n/strings/en_EN.json
@@ -133,10 +133,12 @@
"To use it, just wait for autocomplete results to load and tab through them.": "To use it, just wait for autocomplete results to load and tab through them.",
"Upgrades a room to a new version": "Upgrades a room to a new version",
"Room upgrade confirmation": "Room upgrade confirmation",
- "Upgrading your room in this way can be dangerous or unnecessary. Room upgrades are usually done to change the server's behaviour in a given room and not so much anything to do with client (Riot) behaviour.": "Upgrading your room in this way can be dangerous or unnecessary. Room upgrades are usually done to change the server's behaviour in a given room and not so much anything to do with client (Riot) behaviour.",
- "Members of the room will be required to click a link to join the new room. No one will be automatically joined or invited to the new room.": "Members of the room will be required to click a link to join the new room. No one will be automatically joined or invited to the new room.",
- "Please confirm that you'd like to go forward with upgrading this room from %(oldVersion)s to %(newVersion)s": "Please confirm that you'd like to go forward with upgrading this room from %(oldVersion)s to %(newVersion)s",
- "Upgrade Room": "Upgrade Room",
+ "Upgrading a room can be destructive and isn't always necessary.": "Upgrading a room can be destructive and isn't always necessary.",
+ "Room upgrades are usually recommended when a room version is considered