user docs: Update share-a-message-or-conversation.

templates/zerver/for/open-source.md

@@ -51,7 +51,7 @@ or explain a complicated point. Full LaTeX support as well.
 
 ### Permalink from issues to chat
 
-[Permalink to Zulip conversations](/help/share-a-message-or-conversation)
+[Permalink to Zulip conversations](/help/link-to-a-message-or-conversation)
 from your issue tracker. Zulip’s topic-based threading keeps conversations
 coherent and organized.
 

templates/zerver/help/include/sidebar_index.md

@@ -54,7 +54,7 @@
 * [Collapse a message](/help/collapse-a-message)
 * [Star a message](/help/star-a-message)
 * [Emoji reactions](/help/add-an-emoji-reaction-to-a-message)
-* [Share a message or conversation](/help/share-a-message-or-conversation)
+* [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)
 

templates/zerver/help/link-to-a-message-or-conversation.md

@@ -0,0 +1,24 @@
+# Link to a message or conversation
+
+Share permanent links to messages, threads, and streams. The Zulip project
+uses this feature extensively to link to Zulip conversations from our
+issue tracker.
+
+## Link to a stream or topic (web only)
+
+1. Click on a stream or topic in the left sidebar.
+
+1. Copy the URL from your browser's address bar.
+
+!!! tip ""
+    This works for all views, including searches.
+    All URLs in Zulip are permalinks.
+
+## Link to a specific message
+
+{!message-actions-menu.md!}
+
+1. Click **Link to conversation**.
+
+The copied link will take you to the topic of the relevant message, scrolled
+down to that message.

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

@@ -1,20 +0,0 @@
-# Share a message or conversation
-
-A message or conversation can be shared on Zulip by creating
- a link to the conversation and sharing the link.
-
-{!message-actions-menu.md!}
-
-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
- selected message's conversation. Now, the URL in your web browser will link
- directly to the relevant message.
-
-    !!! tip ""
-        **Note:** All the messages in the relevant message's conversation will
-         also be displayed when the link is navigated to.
-
-
-5. The link (URL from your browser) can now be shared!