user docs: Update emoji-reactions.

templates/zerver/help/add-an-emoji-reaction-to-a-message.md

@@ -1,61 +0,0 @@
-# Add an emoji reaction to a message
-
-Instead of replying to a message, you can quickly respond to a message with
-an emoji reaction.
-
-1. Locate the message you want to react to in the message table.
-
-{!message-actions.md!}
-
-1. Click the smiley face (<i class="icon-vector-smile"></i>)
-icon to reveal the emoji reactions picker.  Or, use the `:` hotkey to
-open the emoji reactions picker quickly without using a mouse.
-
-    !!! tip ""
-        For messages that you sent, the picker to add a reaction is
-        instead accessed by clicking the down chevron
-        (<i class="icon-vector-chevron-down"></i>).
-
-3. Locate the emoji you want to choose as your reaction in the emoji
-reactions picker pop-up by using the arrow keys, the scroll-bar on the
-right edge, or filtering the emoji list with the search bar at the
-top.
-
-4. Upon clicking on an emoji in the emoji reactions picker, the
-selected emoji will appear under the message as an emoji reaction.
-
-    !!! tip ""
-        If you want to remove your emoji reaction from a message, simply
-        click on the emoji reaction you previously added to remove it.
-
-## Add an emoji reaction to a message with previous reactions
-
-![Emoji reaction](/static/images/help/emoji-react.png)
-
-Emoji reactions from other users are displayed under the messages they
-reacted to. If you want to add an emoji reaction to a message that was
-previously used by another user, click on the emoji reaction under the
-message.
-
-You can alternatively add a new emoji reaction to a previously-reacted
-message by following the following steps.
-
-1. Hover over a message's previous emoji reactions to reveal a button with
-the smiley face (<i class="icon-vector-smile"></i>) and plus (<i
-class="icon-vector-plus"></i>) icons.
-
-2. Upon clicking on the button, the emoji reactions picker will appear.
-
-3. Locate the emoji you want to choose as your reaction in the emoji
-reactions picker by scrolling through the picker or entering the emoji phrase in
-the picker's search bar.
-
-4. Upon clicking on an emoji in the emoji reactions picker, the selected emoji
-will appear under the message as an emoji reaction.
-
-!!! tip ""
-    Hover over an emoji reaction on a message to see who reacted to the
-    message with the particular emoji.
-
-!!! warn ""
-    **Note:** You can change Zulip to [view emoji reactions as text](/help/view-emoji-as-text).

templates/zerver/help/emoji-reactions.md

@@ -0,0 +1,36 @@
+# Emoji reactions
+
+Emoji reactions allow you to react to messages with fun little emoji. Any
+emoji can be used as a reaction, including
+[custom emoji](/help/add-custom-emoji). Reactions appear in little boxes
+underneath the message.
+
+## Add an emoji reaction
+
+{!message-actions.md!}
+
+1. Click the smiley face (<i class="icon-vector-smile"></i>) icon.
+
+    !!! tip ""
+        For messages that you sent, click the down chevron
+        (<i class="icon-vector-chevron-down"></i>) and then
+        **Add emoji reaction**.
+
+1. Select an emoji. Type to search, use the arrow keys, or click on an emoji
+   with your mouse.
+
+If someone has already added a reaction, you can just click or tap on it to
+second the reaction.
+
+## See who reacted to a message
+
+Hover over an emoji reaction on a message to see who reacted with that emoji.
+
+## Remove an emoji reaction
+
+Reactions you've added have a tinted background. Click or tap on a reaction you
+added to remove it.
+
+## Related articles
+
+* [View emoji reactions as text](/help/view-emoji-as-text)

templates/zerver/help/include/sidebar_index.md

@@ -53,7 +53,7 @@
 * [See all images in a narrow](/help/viewing-images#see-all-images-in-a-narrow)
 * [Collapse a message](/help/collapse-a-message)
 * [Star a message](/help/star-a-message)
-* [Emoji reactions](/help/add-an-emoji-reaction-to-a-message)
+* [Emoji reactions](/help/emoji-reactions)
 * [Link to a message or conversation](/help/link-to-a-message-or-conversation)
 * [Advanced search](/help/search-for-messages)
 * [View a message's edit history](/help/view-a-messages-edit-history)