From 347456752105c89ed209dc016f4a787b1220b596 Mon Sep 17 00:00:00 2001 From: David Rosa Date: Tue, 31 May 2022 11:10:42 -0400 Subject: [PATCH] help-docs: Document "Copy link to topic" mobile app feature. Adds a "Mobile" tab with straightforward instructions for accessing the long-press menu using two new macros. Knowing where to access the long-press menu is intuitive, except when the user is in a topic narrow. It's not immediately obvious that the top bar can be long-pressed so this adds a "Tip block" using a new macro to clarify things in this scenario. Also, this combines the instructions for Desktop and Web into a single tab because the numbered steps work on both platforms. So this documents the alternate method via the browser's address bar as a "Tip block" to avoid stacking alternative numbered steps into a single tab. This updates the stream and message link instructions too. Fixes: #22147. --- .../help/include/message-actions-menu.md | 2 +- .../help/include/topic-long-press-menu-tip.md | 4 ++ .../help/include/topic-long-press-menu.md | 1 + .../help/link-to-a-message-or-conversation.md | 41 +++++++++++-------- 4 files changed, 29 insertions(+), 19 deletions(-) create mode 100644 templates/zerver/help/include/topic-long-press-menu-tip.md create mode 100644 templates/zerver/help/include/topic-long-press-menu.md diff --git a/templates/zerver/help/include/message-actions-menu.md b/templates/zerver/help/include/message-actions-menu.md index db82e8402c..0ff0297ddc 100644 --- a/templates/zerver/help/include/message-actions-menu.md +++ b/templates/zerver/help/include/message-actions-menu.md @@ -1,3 +1,3 @@ 1. Hover over a message to reveal three icons on the right. -1. Click the ellipsis (). +1. Click on the ellipsis (). diff --git a/templates/zerver/help/include/topic-long-press-menu-tip.md b/templates/zerver/help/include/topic-long-press-menu-tip.md new file mode 100644 index 0000000000..fee90cc06b --- /dev/null +++ b/templates/zerver/help/include/topic-long-press-menu-tip.md @@ -0,0 +1,4 @@ +!!! tip "" + + If you are viewing a single topic, you can access the long-press + menu from the bar at the top of the screen. diff --git a/templates/zerver/help/include/topic-long-press-menu.md b/templates/zerver/help/include/topic-long-press-menu.md new file mode 100644 index 0000000000..e50c30e559 --- /dev/null +++ b/templates/zerver/help/include/topic-long-press-menu.md @@ -0,0 +1 @@ +1. Press and hold the topic bar to access the long-press menu. diff --git a/templates/zerver/help/link-to-a-message-or-conversation.md b/templates/zerver/help/link-to-a-message-or-conversation.md index 7bff57dfbd..248742e7fb 100644 --- a/templates/zerver/help/link-to-a-message-or-conversation.md +++ b/templates/zerver/help/link-to-a-message-or-conversation.md @@ -34,9 +34,9 @@ Topic: #**stream name>topic name** ## Link to Zulip from anywhere -All URLs in Zulip are designed to be shareable. -Copying the URL from the browser's address bar will work -for all views, including searches. +All URLs in Zulip are designed to be shareable. Copying the URL from +the browser's address bar will work for all views, including searches. + ### Get a link to a specific message This copies to your clipboard a permanent link to the message, @@ -53,17 +53,16 @@ message](/help/quote-and-reply). {start_tabs} -{tab|desktop} +{tab|desktop-web} {!message-actions-menu.md!} 1. Click **Copy link to message**. -{tab|web} +!!! tip "" -1. Click on the timestamp of the message. - -1. Copy the URL from your browser's address bar. + If using Zulip in a browser, you can also click on the timestamp + of a message, and copy the URL from your browser's address bar. {end_tabs} @@ -71,34 +70,40 @@ message](/help/quote-and-reply). {start_tabs} -{tab|desktop} +{tab|desktop-web} {!topic-actions.md!} 1. Click **Copy link to topic**. -{tab|web} +!!! tip "" -1. Click on a topic in the left sidebar. + If using Zulip in a browser, you can also click on a topic name, + and copy the URL from your browser's address bar. -1. Copy the URL from your browser's address bar. +{tab|mobile} + +{!topic-long-press-menu.md!} + +1. Tap **Copy link to topic**. + +{!topic-long-press-menu-tip.md!} {end_tabs} ### Get a link to a specific stream {start_tabs} -{tab|desktop} +{tab|desktop-web} -1. Right-click on the stream in the left sidebar. +1. Right-click on a stream in the left sidebar. 1. Click **Copy Link**. -{tab|web} +!!! tip "" -1. Click on a stream in the left sidebar. - -1. Copy the URL from your browser's address bar. + If using Zulip in a browser, you can also click on a stream in the + left sidebar, and copy the URL from your browser's address bar. {end_tabs}