From 3d63ea20b61b2951cb1dcae2cfd191546ba846b1 Mon Sep 17 00:00:00 2001 From: David Rosa Date: Wed, 28 Feb 2024 18:55:11 -0700 Subject: [PATCH] help: Add "View stream subscribers" page. Documents how to view stream subscribers via settings and the right sidebar. Fixes #28887. --- help/add-or-remove-users-from-a-stream.md | 7 +-- help/include/sidebar_index.md | 1 + .../stream-menu-subscribers-tab-tip.md | 5 +++ help/manage-user-stream-subscriptions.md | 1 + help/view-stream-subscribers.md | 44 +++++++++++++++++++ zerver/lib/markdown/tabbed_sections.py | 1 + 6 files changed, 54 insertions(+), 5 deletions(-) create mode 100644 help/include/stream-menu-subscribers-tab-tip.md create mode 100644 help/view-stream-subscribers.md diff --git a/help/add-or-remove-users-from-a-stream.md b/help/add-or-remove-users-from-a-stream.md index cefd29e8cc..83642570f1 100644 --- a/help/add-or-remove-users-from-a-stream.md +++ b/help/add-or-remove-users-from-a-stream.md @@ -127,11 +127,7 @@ subscribe the user. 1. Click the **Unsubscribe** button in that row. -!!! tip "" - - You can also hover over a stream in the left sidebar, click on the - **ellipsis** (), and - select **Stream settings** to access the **Subscribers** tab. +{!stream-menu-subscribers-tab-tip.md!} {end_tabs} @@ -163,3 +159,4 @@ This method is useful if you need to remove one user from multiple streams. * [Set default streams for new users](/help/set-default-streams-for-new-users) * [Roles and permissions](/help/roles-and-permissions) * [Mention a user or group](/help/mention-a-user-or-group) +* [View stream subscribers](/help/view-stream-subscribers) diff --git a/help/include/sidebar_index.md b/help/include/sidebar_index.md index ce5ae1825a..31d13709c6 100644 --- a/help/include/sidebar_index.md +++ b/help/include/sidebar_index.md @@ -127,6 +127,7 @@ * [Browse and subscribe to streams](/help/browse-and-subscribe-to-streams) * [Unsubscribe from a stream](/help/unsubscribe-from-a-stream) * [Create a stream](/help/create-a-stream) +* [View stream subscribers](/help/view-stream-subscribers) * [Add or remove users from a stream](/help/add-or-remove-users-from-a-stream) * [Pin a stream](/help/pin-a-stream) * [Change the color of a stream](/help/change-the-color-of-a-stream) diff --git a/help/include/stream-menu-subscribers-tab-tip.md b/help/include/stream-menu-subscribers-tab-tip.md new file mode 100644 index 0000000000..54e3bac87e --- /dev/null +++ b/help/include/stream-menu-subscribers-tab-tip.md @@ -0,0 +1,5 @@ +!!! tip "" + + You can also hover over a stream in the left sidebar, click on the + **ellipsis** (), and + select **Stream settings** to access the **Subscribers** tab. diff --git a/help/manage-user-stream-subscriptions.md b/help/manage-user-stream-subscriptions.md index 69e8f04cc7..32fcca7720 100644 --- a/help/manage-user-stream-subscriptions.md +++ b/help/manage-user-stream-subscriptions.md @@ -91,5 +91,6 @@ stream](/help/unsubscribe-from-a-stream). * [Roles and permissions](/help/roles-and-permissions) * [Add or remove users from a stream](/help/add-or-remove-users-from-a-stream) * [Unsubscribe from a stream](/help/unsubscribe-from-a-stream) +* [View stream subscribers](/help/view-stream-subscribers) [configure-invites]: /help/configure-who-can-invite-to-streams diff --git a/help/view-stream-subscribers.md b/help/view-stream-subscribers.md new file mode 100644 index 0000000000..1e79c96dcd --- /dev/null +++ b/help/view-stream-subscribers.md @@ -0,0 +1,44 @@ +# View stream subscribers + +Who is subscribed to a stream determines who receives the messages sent there. +All non-[guest](/help/guest-users) users can view public streams and subscribe +themselves. Organization administrators can +[configure](/help/configure-who-can-invite-to-streams) who can subscribe and +unsubscribe other users to streams. + +## View stream subscribers + +{start_tabs} + +{tab|via-stream-settings} + +{relative|stream|all} + +1. Select a stream. + +{!select-stream-view-subscribers.md!} + +{!stream-menu-subscribers-tab-tip.md!} + +{tab|via-right-sidebar} + +1. Click on a stream in the left sidebar. + +1. View subscribers in the **In this stream** section in the right sidebar. If + the section is collapsed, click **In this stream** to reveal it. + +!!! tip "" + + To see the full list of subscribers for a stream that has more than 600 + people subscribed, scroll to the bottom of the **In this stream** section, + and click **View all subscribers**. + +{end_tabs} + +## Related articles + +* [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) +* [Add or remove users from a stream](/help/add-or-remove-users-from-a-stream) +* [Set default streams for new users](/help/set-default-streams-for-new-users) diff --git a/zerver/lib/markdown/tabbed_sections.py b/zerver/lib/markdown/tabbed_sections.py index a6fe33e3ce..9fdb36fa7e 100644 --- a/zerver/lib/markdown/tabbed_sections.py +++ b/zerver/lib/markdown/tabbed_sections.py @@ -77,6 +77,7 @@ TAB_SECTION_LABELS = { "via-recent-conversations": "Via recent conversations", "via-inbox-view": "Via inbox view", "via-left-sidebar": "Via left sidebar", + "via-right-sidebar": "Via right sidebar", "instructions-for-all-platforms": "Instructions for all platforms", "public-streams": "Public streams", "private-streams": "Private streams",