From 861da7ced874f9440b6f12b10cb2ecb7db7e66fb Mon Sep 17 00:00:00 2001 From: Lauryn Menard Date: Mon, 2 May 2022 16:55:49 +0200 Subject: [PATCH] help-docs: Add manage a user's stream subscriptions article. Adds a new help center article focused on managing a single user's stream subscriptions. Creates a shared file for instructions to navigate to a user's full profile via the right sidebar, which is used in three help center articles. Fixes #21795. --- .../help/add-or-remove-users-from-a-stream.md | 15 +++-- .../right-sidebar-view-full-profile.md | 6 ++ .../zerver/help/include/sidebar_index.md | 1 + .../help/manage-user-stream-subscriptions.md | 64 +++++++++++++++++++ .../zerver/help/view-someones-profile.md | 7 +- 5 files changed, 81 insertions(+), 12 deletions(-) create mode 100644 templates/zerver/help/include/right-sidebar-view-full-profile.md create mode 100644 templates/zerver/help/manage-user-stream-subscriptions.md diff --git a/templates/zerver/help/add-or-remove-users-from-a-stream.md b/templates/zerver/help/add-or-remove-users-from-a-stream.md index b623b73991..dd80b947fb 100644 --- a/templates/zerver/help/add-or-remove-users-from-a-stream.md +++ b/templates/zerver/help/add-or-remove-users-from-a-stream.md @@ -62,12 +62,7 @@ This method is useful if you need to remove one user from multiple streams. {start_tabs} -1. Hover over a user's name in the right sidebar. - -1. Click on the ellipsis () to - the right of their name. - -1. Click **View full profile**. +{!right-sidebar-view-full-profile.md!} 1. Select the **Streams** tab. @@ -77,3 +72,11 @@ This method is useful if you need to remove one user from multiple streams. 1. Click the **Unsubscribe** button in that row. {end_tabs} + +## Related topics + +* [Browse and subscribe to streams](/help/browse-and-subscribe-to-streams) +* [Unsubscribe from a stream](/help/unsubscribe-from-a-stream) +* [Manage a user's stream subscriptions](/help/manage-user-stream-subscriptions) +* [Restrict stream invitation](/help/configure-who-can-invite-to-streams) +* [Set default streams for new users](/help/set-default-streams-for-new-users) diff --git a/templates/zerver/help/include/right-sidebar-view-full-profile.md b/templates/zerver/help/include/right-sidebar-view-full-profile.md new file mode 100644 index 0000000000..38ebf5e357 --- /dev/null +++ b/templates/zerver/help/include/right-sidebar-view-full-profile.md @@ -0,0 +1,6 @@ +1. Hover over a user's name in the right sidebar. + +1. Click on the ellipsis () + to the right of their name. + +1. Click **View full profile**. diff --git a/templates/zerver/help/include/sidebar_index.md b/templates/zerver/help/include/sidebar_index.md index 40ccf29058..4308641930 100755 --- a/templates/zerver/help/include/sidebar_index.md +++ b/templates/zerver/help/include/sidebar_index.md @@ -157,6 +157,7 @@ * [Restrict visibility of email addresses](/help/restrict-visibility-of-email-addresses) * [Change a user's role](/help/change-a-users-role) * [Change a user's name](/help/change-a-users-name) +* [Manage a user's stream subscriptions](/help/manage-user-stream-subscriptions) * [Restrict name and email changes](/help/restrict-name-and-email-changes) * [Restrict profile picture changes](/help/restrict-profile-picture-changes) * [Restrict permissions of new members](/help/restrict-permissions-of-new-members) diff --git a/templates/zerver/help/manage-user-stream-subscriptions.md b/templates/zerver/help/manage-user-stream-subscriptions.md new file mode 100644 index 0000000000..018b24290f --- /dev/null +++ b/templates/zerver/help/manage-user-stream-subscriptions.md @@ -0,0 +1,64 @@ +# Manage a user's stream subscriptions + +## View a user's stream subscriptions + +!!! warn "" + + Note that the list of a user's **Subscribed streams** will be limited to + streams for which [you can see all subscribers](/help/stream-permissions). + +{start_tabs} + +{!right-sidebar-view-full-profile.md!} + +1. Select the **Streams** tab. + +{end_tabs} + +## Subscribe a user to a stream + +Organization administrators can configure which +[roles](/help/roles-and-permissions) have access to [subscribe +other users to a stream][configure-invites]. + +{start_tabs} + +{relative|stream|all} + +1. Select a stream. + +{!select-stream-view-subscribers.md!} + +1. Under **Add subscribers**, enter the user's name or email address. + +1. Click **Add**. + +{end_tabs} + +## Unsubscribe a user from stream(s) + +{!admin-only.md!} + +Anyone can always [unsubscribe themselves from a +stream](/help/unsubscribe-from-a-stream). + +{start_tabs} + +{!right-sidebar-view-full-profile.md!} + +1. Select the **Streams** tab. + +1. Under **Subscribed streams**, find the stream you would like + to remove the user from. + +1. Click the **Unsubscribe** button in that row. + +{end_tabs} + +## Related topics + +* [Stream permissions](/help/stream-permissions) +* [Roles and permissions](/help/roles-and-permissions) +* [Add or remove users from a stream](/help/add-or-remove-users-from-a-stream) + +[configure-invites]: /help/configure-who-can-invite-to-streams diff --git a/templates/zerver/help/view-someones-profile.md b/templates/zerver/help/view-someones-profile.md index eff1bae4d1..31fc50e9a7 100644 --- a/templates/zerver/help/view-someones-profile.md +++ b/templates/zerver/help/view-someones-profile.md @@ -24,12 +24,7 @@ streams for which [you can see all subscribers](/help/stream-permissions). {start_tabs} -1. Hover over a user's name in the right sidebar. - -1. Click on the ellipsis () to - the right of their name. - -1. Click **View full profile**. +{!right-sidebar-view-full-profile.md!} {end_tabs}