help: Create "Configure send message keys" article.

Document setting the keys that will send a message or create a new
line when composting a message via the compose box and via the
personal settings overlay.

Updates links and redirect from former help center article about
this feature.

Fixes #31620.

help/collaborative-to-do-lists.md

@@ -10,12 +10,13 @@
 
 1. Make sure the compose box is empty.
 
-2. Type `/todo` followed by a space, and the title of the to-do list.
+1. Type `/todo` followed by a space, and the title of the to-do list.
 
-3. _(optional)_ Type each task on a new line, with its description, if any, after a <kbd>:</kbd> and blank space.
+1. _(optional)_ Type each task on a new line, with its description, if
+   any, after a <kbd>:</kbd> and blank space.
 
-4. Click the **Send** (<i class="zulip-icon zulip-icon-send"></i>) button, or
+1. Click the **Send** (<i class="zulip-icon zulip-icon-send"></i>)
-   use a [keyboard shortcut](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message)
+   button, or use a [keyboard shortcut](/help/configure-send-message-keys)
    to send your message.
 
 !!! tip ""
@@ -28,7 +29,8 @@
 
 {start_tabs}
 
-1. Fill out the **New task** field and optionally the **Description** field at the bottom of the to-do list.
+1. Fill out the **New task** field and optionally the **Description**
+   field at the bottom of the to-do list.
 
 1. Click **Add task** to add the new task to the to-do list.
 

help/configure-send-message-keys.md

@@ -0,0 +1,41 @@
+# Configure send message keys
+
+By default, the <kbd>Enter</kbd> key adds a new line to your message,
+and <kbd>Ctrl</kbd> + <kbd>Enter</kbd> sends your message.
+
+This is convenient for typing multi-line messages, which are more common in
+Zulip than in most other chat products. However, you can also configure
+Zulip so that the <kbd>Enter</kbd> key sends your message.
+
+!!! tip ""
+
+    <kbd>Shift</kbd> + <kbd>Enter</kbd> always adds a new line, regardless
+    of whether **<kbd>Enter</kbd> to send** is enabled.
+
+## Configure send message keys
+
+{start_tabs}
+
+{tab|via-compose-box}
+
+{!start-composing.md!}
+
+1. Click on the **ellipsis** (<i class="zulip-icon zulip-icon-more-vertical"></i>)
+   in the bottom right corner of the compose box, next to the **Send**
+   (<i class="zulip-icon zulip-icon-send"></i>) button.
+
+1. Toggle your preferred option for **Press ... to send**.
+
+{tab|via-personal-settings}
+
+{settings_tab|preferences}
+
+1. Under **General**, toggle **<kbd>Enter</kbd> sends when composing a message**.
+
+{end_tabs}
+
+## Related articles
+
+* [Message formatting](/help/format-your-message-using-markdown)
+* [Preview messages before sending](/help/preview-your-message-before-sending)
+* [Mastering the compose box](/help/mastering-the-compose-box)

help/create-a-poll.md

@@ -21,9 +21,8 @@ edit the question.
    formatting.
 
 1. Click the **Send** (<i class="zulip-icon zulip-icon-send"></i>) button, or
-   use a [keyboard
+   use a [keyboard shortcut](/help/configure-send-message-keys) to send your
-   shortcut](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message)
+   message.
-   to send your message.
 
 !!! tip ""
 
@@ -43,8 +42,8 @@ edit the question.
 3. _(optional)_ Type each option on a new line.
 
 4. Click the **Send** (<i class="zulip-icon zulip-icon-send"></i>) button, or
-   use a [keyboard shortcut](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message)
+   use a [keyboard shortcut](/help/configure-send-message-keys) to send your
-   to send your message.
+   message.
 
 !!! tip ""
 

help/include/compose-and-send-message.md

@@ -3,5 +3,5 @@
    sending.
 
 1. Click the **Send** (<i class="zulip-icon zulip-icon-send"></i>) button, or
-   use a [keyboard shortcut](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message)
+   use a [keyboard shortcut](/help/configure-send-message-keys) to send your
-   to send your message.
+   message.

help/include/replying-to-messages.md

@@ -9,8 +9,8 @@ To reply to an existing thread:
    sending.
 
 1. Click the **Send** (<i class="zulip-icon zulip-icon-send"></i>) button, or
-   use a [keyboard shortcut](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message)
+   use a [keyboard shortcut](/help/configure-send-message-keys) to send your
-   to send your message.
+   message.
 
 !!! tip ""
     You can also reply by clicking on a message, or using the <kbd>R</kbd> or

help/include/set-up-your-account.md

@@ -19,8 +19,8 @@
 
 - [Browse and subscribe to channels](/help/introduction-to-channels#browse-and-subscribe-to-channels).
 
-- Decide whether you want <kbd>Enter</kbd> [to send your message
+- Decide whether you want <kbd>Enter</kbd> [to send your message or add a
-  or add a new line](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message).
+  new line](/help/configure-send-message-keys).
 
 - [Configure your notifications](/#settings/notifications) to work the way
   you do. If you're joining a low traffic organization and aren't using the

help/include/sidebar_index.md

@@ -46,6 +46,7 @@
 
 ## Preferences
 * [Dark theme](/help/dark-theme)
+* [Configure send message keys](/help/configure-send-message-keys)
 * [Font size](/help/font-size)
 * [Change your language](/help/change-your-language)
 * [Change your time zone](/help/change-your-timezone)

help/keyboard-shortcuts.md

@@ -145,7 +145,7 @@ in the Zulip app to add more to your repertoire as needed.
   <kbd>Enter</kbd> or <kbd>Ctrl</kbd> + <kbd>Enter</kbd> based on
   [your settings][toggle-enter-to-send]
 
-[toggle-enter-to-send]: /help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message
+[toggle-enter-to-send]: /help/configure-send-message-keys
 
 * **Insert italic text**: `*italic*` or <kbd>Ctrl</kbd> + <kbd>I</kbd>
 

help/mastering-the-compose-box.md

@@ -78,51 +78,10 @@ where you sent a message**, as desired.
 
 {end_tabs}
 
-## Toggle between <kbd>Ctrl</kbd> + <kbd>Enter</kbd> and <kbd>Enter</kbd> to send a message
-
-By default, the <kbd>Enter</kbd> key adds a new line to your message,
-and <kbd>Ctrl</kbd> + <kbd>Enter</kbd> sends your message.
-
-This is convenient for typing multi-line messages, which are more common in
-Zulip than in most other chat products. However, you can also configure
-Zulip so that the <kbd>Enter</kbd> key sends your message.
-
-!!! tip ""
-
-    <kbd>Shift</kbd> + <kbd>Enter</kbd> always adds a new line, regardless
-    of whether **<kbd>Enter</kbd> to send** is enabled.
-
-### Enable <kbd>Enter</kbd> to send
-
-{start_tabs}
-
-{!start-composing.md!}
-
-1. Click on the **ellipsis** (<i class="zulip-icon zulip-icon-more-vertical"></i>)
-   in the bottom right corner of the compose box, next to the **Send**
-   (<i class="zulip-icon zulip-icon-send"></i>) button.
-
-1. Select **<kbd>Enter</kbd> to send**.
-
-{end_tabs}
-
-### Enable **<kbd>Ctrl</kbd> + <kbd>Enter</kbd> to send**
-
-{start_tabs}
-
-{!start-composing.md!}
-
-1. Click on the **ellipsis** (<i class="zulip-icon zulip-icon-more-vertical"></i>)
-   in the bottom right corner of the compose box, next to the **Send**
-   (<i class="zulip-icon zulip-icon-send"></i>) button.
-
-1. Select **<kbd>Ctrl</kbd> + <kbd>Enter</kbd> to send**.
-
-{end_tabs}
-
 ## Related articles
 
 * [Resize the compose box](/help/resize-the-compose-box)
 * [Message formatting](/help/format-your-message-using-markdown)
 * [Preview messages before sending](/help/preview-your-message-before-sending)
+* [Configure send message keys](/help/configure-send-message-keys)
 * [Messaging tips and tricks](/help/messaging-tips)

zerver/lib/markdown/tabbed_sections.py

@@ -88,6 +88,7 @@ TAB_SECTION_LABELS = {
     "via-organization-settings": "Via organization settings",
     "via-personal-settings": "Via personal settings",
     "via-channel-settings": "Via channel settings",
+    "via-compose-box": "Via compose box",
     "default-subdomain": "Default subdomain",
     "custom-subdomain": "Custom subdomain",
     "zulip-cloud-standard": "Zulip Cloud Standard",

zerver/lib/url_redirects.py

@@ -36,10 +36,7 @@ HELP_DOCUMENTATION_REDIRECTS: list[URLRedirect] = [
         "/help/add-custom-profile-fields",
         "/help/custom-profile-fields",
     ),
-    URLRedirect(
+    URLRedirect("/help/enable-enter-to-send", "/help/configure-send-message-keys"),
-        "/help/enable-enter-to-send",
-        "/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message",
-    ),
     URLRedirect(
         "/help/change-the-default-language-for-your-organization",
         "/help/configure-organization-language",

zerver/openapi/zulip.yaml

@@ -15130,7 +15130,7 @@ paths:
                           enter_sends:
                             type: boolean
                             description: |
-                              Whether the user setting for [sending on pressing Enter](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message)
+                              Whether the user setting for [sending on pressing Enter](/help/configure-send-message-keys)
                               in the compose box is enabled.
                           enable_drafts_synchronization:
                             type: boolean
@@ -16107,7 +16107,7 @@ paths:
                           `update_display_settings`.
 
                           [capabilities]: /api/register-queue#parameter-client_capabilities
-                          [set-enter-send]: /help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message
+                          [set-enter-send]: /help/configure-send-message-keys
                       emojiset_choices:
                         deprecated: true
                         description: |
@@ -17828,7 +17828,7 @@ paths:
                           enter_sends:
                             type: boolean
                             description: |
-                              Whether the user setting for [sending on pressing Enter](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message)
+                              Whether the user setting for [sending on pressing Enter](/help/configure-send-message-keys)
                               in the compose box is enabled.
                           enable_drafts_synchronization:
                             type: boolean