From da759d60f8c02c17850f7c652a2026f30942fb8c Mon Sep 17 00:00:00 2001 From: Rishi Gupta Date: Sun, 16 Sep 2018 08:23:45 -0700 Subject: [PATCH] user docs: Add the message-actions-menu macro. --- docs/subsystems/user-docs.md | 4 ++++ templates/zerver/help/change-the-topic-of-a-message.md | 2 +- templates/zerver/help/collapse-a-message.md | 3 +-- templates/zerver/help/edit-or-delete-a-message.md | 3 +-- templates/zerver/help/include/message-actions-menu.md | 3 +++ templates/zerver/help/mute-a-topic.md | 2 +- templates/zerver/help/reply-to-a-message.md | 3 +-- templates/zerver/help/share-a-message-or-conversation.md | 7 ++----- templates/zerver/help/view-a-messages-edit-history.md | 3 +-- .../zerver/help/view-the-markdown-source-of-a-message.md | 3 +-- 10 files changed, 16 insertions(+), 17 deletions(-) create mode 100644 templates/zerver/help/include/message-actions-menu.md diff --git a/docs/subsystems/user-docs.md b/docs/subsystems/user-docs.md index f4fd1ca7f0..785c38566f 100644 --- a/docs/subsystems/user-docs.md +++ b/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. diff --git a/templates/zerver/help/change-the-topic-of-a-message.md b/templates/zerver/help/change-the-topic-of-a-message.md index 88321eef95..f0effcaf78 100644 --- a/templates/zerver/help/change-the-topic-of-a-message.md +++ b/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 (). +{!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 diff --git a/templates/zerver/help/collapse-a-message.md b/templates/zerver/help/collapse-a-message.md index 6ab7b22653..bcc7a3201e 100644 --- a/templates/zerver/help/collapse-a-message.md +++ b/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!} -{!down-chevron.md!} +{!message-actions-menu.md!} 3. Click on the **Collapse** option from the actions dropdown to collapse a message. diff --git a/templates/zerver/help/edit-or-delete-a-message.md b/templates/zerver/help/edit-or-delete-a-message.md index 9311bcc4cc..a6ad112131 100644 --- a/templates/zerver/help/edit-or-delete-a-message.md +++ b/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!} -{!down-chevron.md!} +{!message-actions-menu.md!} 2. Select the **Delete message** option from the dropdown to delete that message. diff --git a/templates/zerver/help/include/message-actions-menu.md b/templates/zerver/help/include/message-actions-menu.md new file mode 100644 index 0000000000..c03303795b --- /dev/null +++ b/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 (). diff --git a/templates/zerver/help/mute-a-topic.md b/templates/zerver/help/mute-a-topic.md index 3493493cf5..def41b9dbc 100644 --- a/templates/zerver/help/mute-a-topic.md +++ b/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 (). +{!message-actions-menu.md!} 1. Select **Mute (or unmute) the topic **. diff --git a/templates/zerver/help/reply-to-a-message.md b/templates/zerver/help/reply-to-a-message.md index cadb83a8bf..52215d4781 100644 --- a/templates/zerver/help/reply-to-a-message.md +++ b/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!} -{!down-chevron.md!} +{!message-actions-menu.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 diff --git a/templates/zerver/help/share-a-message-or-conversation.md b/templates/zerver/help/share-a-message-or-conversation.md index 34784955d3..5b8c52bde0 100644 --- a/templates/zerver/help/share-a-message-or-conversation.md +++ b/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!}. - -3. Click on the {!down-chevron.md!} and select - the **Link to conversation** option from the dropdown. +1. Click **Link to conversation**. 4. Upon clicking **Link to conversation**, **topic** and **near** search operators will be used to create a link that narrows your messages to the diff --git a/templates/zerver/help/view-a-messages-edit-history.md b/templates/zerver/help/view-a-messages-edit-history.md index 3f34b29db6..1cfd6305dc 100644 --- a/templates/zerver/help/view-a-messages-edit-history.md +++ b/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!} -{!down-chevron.md!} +{!message-actions-menu.md!} 1. Click **View edit history**. diff --git a/templates/zerver/help/view-the-markdown-source-of-a-message.md b/templates/zerver/help/view-the-markdown-source-of-a-message.md index 4c18d90ca5..51afe795ea 100644 --- a/templates/zerver/help/view-the-markdown-source-of-a-message.md +++ b/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!} -{!down-chevron.md!} +{!message-actions-menu.md!} 3. Click **View source**.