From 7aa93d3447d61148d667a1bb6f4755ce077c595d Mon Sep 17 00:00:00 2001 From: Lauryn Menard Date: Tue, 29 Jul 2025 19:31:46 +0200 Subject: [PATCH] help: Improve emoji reactions documentation. --- help/emoji-reactions.md | 37 ++++++---------------------- help/include/view-emoji-reactions.md | 22 +++++++++++++++++ help/keyboard-shortcuts.md | 11 ++++----- help/reading-strategies.md | 4 +++ web/templates/keyboard_shortcuts.hbs | 16 ++++++------ 5 files changed, 46 insertions(+), 44 deletions(-) create mode 100644 help/include/view-emoji-reactions.md diff --git a/help/emoji-reactions.md b/help/emoji-reactions.md index 54418a0fd5..85eb0e02f7 100644 --- a/help/emoji-reactions.md +++ b/help/emoji-reactions.md @@ -14,13 +14,10 @@ message. {!message-actions.md!} -1. Click the **smiley face** () icon. - - !!! warn "" - - For messages that you've sent, click on the **ellipsis** - () and then - **Add emoji reaction**. +1. Click the **Add emoji reaction** () icon. On messages that you sent, click on the + **ellipsis** (), + then **Add emoji reaction**. 1. Select an emoji. Type to search, use the arrow keys, or click on an emoji with your mouse. @@ -32,7 +29,8 @@ message. !!! keyboard_tip "" - You can react to the selected message with 👍 by using the + shortcut. + Use : to add any reaction, = to add the first + emoji reaction added by others, or + to react with 👍. {tab|mobile} @@ -111,28 +109,7 @@ so](#toggle-whether-names-of-reacting-users-are-displayed) is enabled. ## View your messages with reactions -To see how others have responded to your messages, you can view all your -messages which have received at least one reaction. - -{start_tabs} - -{tab|desktop-web} - -1. Click on **Reactions** in the left - sidebar. If the **views** section is collapsed, click on - the **ellipsis** (), - and select **Reactions**. - -1. Browse your reactions. You can click on a message recipient bar to go - to the [conversation](/help/reading-conversations) where you sent the message. - -!!! tip "" - - You can also [search all messages with reactions](/help/search-for-messages) using the - `has:reaction` filter. - -{end_tabs} - +{!view-emoji-reactions.md!} ## Related articles diff --git a/help/include/view-emoji-reactions.md b/help/include/view-emoji-reactions.md new file mode 100644 index 0000000000..c40dfa8a42 --- /dev/null +++ b/help/include/view-emoji-reactions.md @@ -0,0 +1,22 @@ +The reactions view lets you see all of your messages that have received at least +one [emoji reaction](/help/emoji-reactions). You can see what resonated with +others, or confirm that key stakeholders have seen and responded to a message. + +{start_tabs} + +{tab|desktop-web} + +1. Click on **Reactions** in the left + sidebar. If the **views** section is collapsed, click on + the **ellipsis** (), + and select **Reactions**. + +1. Browse your reactions. You can click on a message recipient bar to go + to the [conversation](/help/reading-conversations) where you sent the message. + +!!! tip "" + + You can also [search all messages with reactions](/help/search-for-messages) using the + `has:reaction` filter. + +{end_tabs} diff --git a/help/keyboard-shortcuts.md b/help/keyboard-shortcuts.md index 41eed60e31..42db917316 100644 --- a/help/keyboard-shortcuts.md +++ b/help/keyboard-shortcuts.md @@ -129,6 +129,7 @@ reference in the Zulip app to add more to your repertoire as needed. ### For a selected message (outlined in blue) +* **Toggle message actions menu**: I * **Edit message or view original message**: E * **Show message sender's user card**: U * **View read receipts**: Shift + V — Same shortcut @@ -139,8 +140,9 @@ reference in the Zulip app to add more to your repertoire as needed. H. Viewing message edit history [must be allowed](/help/restrict-message-edit-history-access). * **Star message**: Ctrl + S -* **React with 👍**: + +* **Add emoji reaction**: : * **Toggle first emoji reaction**: = +* **React with 👍**: + * **Mark as unread from selected message**: Shift + U * **Collapse/show message**: - * **Toggle topic mute**: Shift + M. This works in both @@ -175,11 +177,8 @@ Keyboard navigation (e.g., arrow keys) works as expected. * **Toggle gear menu**: G * **Open personal menu**: G + → * **Open help menu**: G + ← - -### For a selected message (outlined in blue) - -* **Toggle emoji reactions menu**: : -* **Toggle message actions menu**: I +* **Toggle message actions menu** for a selected message (outlined in blue): + I ## Channel settings diff --git a/help/reading-strategies.md b/help/reading-strategies.md index 60bb12bcf5..4876198fd3 100644 --- a/help/reading-strategies.md +++ b/help/reading-strategies.md @@ -76,6 +76,10 @@ You can [star messages](/help/star-a-message) that you plan to follow up on late {!view-starred-messages.md!} +### Reactions + +{!view-emoji-reactions.md!} + ## Related articles * [Getting started with Zulip](/help/getting-started-with-zulip) diff --git a/web/templates/keyboard_shortcuts.hbs b/web/templates/keyboard_shortcuts.hbs index d070dbf7dc..e0becef31e 100644 --- a/web/templates/keyboard_shortcuts.hbs +++ b/web/templates/keyboard_shortcuts.hbs @@ -293,6 +293,14 @@ {{t 'Star selected message' }} Ctrl + S + + {{t 'Add emoji reaction to selected message' }} + : + + + {{t 'Toggle first emoji reaction on selected message' }} + = + {{t 'React to selected message with' }} @@ -303,10 +311,6 @@ + - - {{t 'Toggle first emoji reaction on selected message' }} - = - {{t 'Mark as unread from selected message' }} Shift + U @@ -382,10 +386,6 @@ {{t 'Open message menu' }} I - - {{t 'Open reactions menu' }} - : - {{t 'Show keyboard shortcuts' }} ?