user docs: Add the message-actions-menu macro.

docs/subsystems/user-docs.md

@@ -257,6 +257,10 @@ icon to reveal an actions dropdown.
 
 First step to navigating to the on-hover message actions.
 
+### **Message actions menu** `{!message-actions-menu.md!}` macro
+
+Navigate to the message actions menu.
+
 ### **Save changes** `{!save-changes.md!}` macro
 
 Save changes after modifying organization settings.

templates/zerver/help/change-the-topic-of-a-message.md

@@ -10,7 +10,7 @@ message editing entirely. See the
 [guide to message and topic editing](/help/configure-message-editing-and-deletion)
 for the details on when topic editing is allowed.
 
-{!message-actions.md!} down chevron (<i class="icon-vector-chevron-down"></i>).
+{!message-actions-menu.md!}
 
 1. Select the first option. It may be called **View source / Edit topic**,
    or simply **Edit**. If it's called **View source**, then you are not

templates/zerver/help/collapse-a-message.md

@@ -3,8 +3,7 @@
 Zulip allows you to collapse messages by hiding their contents to reduce message
 clutter.
 
-{!message-actions.md!}
+{!message-actions-menu.md!}
-{!down-chevron.md!}
 
 3. Click on the **Collapse** option from the actions dropdown to collapse a
 message.

templates/zerver/help/edit-or-delete-a-message.md

@@ -55,8 +55,7 @@ changed by an organization administrator.
 
 To delete a message:
 
-{!message-actions.md!}
+{!message-actions-menu.md!}
-{!down-chevron.md!}
 
 2. Select the **Delete message** option from the dropdown to delete that message.
 

templates/zerver/help/include/message-actions-menu.md

@@ -0,0 +1,3 @@
+1. Hover over a message to reveal three icons on the right.
+
+1. Click the down chevron (<i class="icon-vector-chevron-down"></i>).

templates/zerver/help/mute-a-topic.md

@@ -22,7 +22,7 @@ Muted topics still appear in the left sidebar, though they are grayed out.
 
 1. Find a message belonging to the topic that you wish to mute or unmute.
 
-{!message-actions.md!} down chevron (<i class="icon-vector-chevron-down"></i>).
+{!message-actions-menu.md!}
 
 1. Select **Mute (or unmute) the topic <topic name\>**.
 

templates/zerver/help/reply-to-a-message.md

@@ -17,8 +17,7 @@ message to the specified stream under the specified topic by pressing the
 Enter key or clicking the **Send** button, depending on your settings.
 
 ## Reply to a message through the message actions dropdown
-{!message-actions.md!}
+{!message-actions-menu.md!}
-{!down-chevron.md!}
 
 2. Select the **Reply** option from the dropdown to reply to the selected
 message. A message compose box will appear with the **Stream** (outlined in red

templates/zerver/help/share-a-message-or-conversation.md

@@ -3,12 +3,9 @@
 A message or conversation can be shared on Zulip by creating
  a link to the conversation and sharing the link.
 
-1. To create a link to a conversation, first locate the relevant message.
+{!message-actions-menu.md!}
 
-2. Hover over the message to reveal a {!down-chevron.md!}.
+1. Click **Link to conversation**.
-
-3. Click on the {!down-chevron.md!} and select
- the **Link to conversation** option from the dropdown.
 
 4. Upon clicking **Link to conversation**, **topic** and **near** search
  operators will be used to create a link that narrows your messages to the

templates/zerver/help/view-a-messages-edit-history.md

@@ -9,8 +9,7 @@ Organization administrators can
 
 ## View a message's edit history
 
-{!message-actions.md!}
+{!message-actions-menu.md!}
-{!down-chevron.md!}
 
 1. Click **View edit history**.
 

templates/zerver/help/view-the-markdown-source-of-a-message.md

@@ -3,8 +3,7 @@
 You can view the Markdown source of a message to learn how the message was
 formatted, or to copy the Markdown source for a reply.
 
-{!message-actions.md!}
+{!message-actions-menu.md!}
-{!down-chevron.md!}
 
 3. Click **View source**.