From b11bf32f8f9962d64c7bfcb0c6868f412dfe302b Mon Sep 17 00:00:00 2001
From: Alya Abbott <alya@zulip.com>
Date: Thu, 28 Mar 2024 13:37:23 -0700
Subject: [PATCH] help: Document user list in the right sidebar.

---
 help/include/sidebar_index.md |  1 +
 help/search-for-messages.md   |  1 +
 help/user-list.md             | 59 +++++++++++++++++++++++++++++++++++
 3 files changed, 61 insertions(+)
 create mode 100644 help/user-list.md

diff --git a/help/include/sidebar_index.md b/help/include/sidebar_index.md
index d42fa20d8b..653379fc73 100644
--- a/help/include/sidebar_index.md
+++ b/help/include/sidebar_index.md
@@ -116,6 +116,7 @@
 * [Read receipts](/help/read-receipts)
 
 ## People
+* [User list](/help/user-list)
 * [Status and availability](/help/status-and-availability)
 * [User cards](/help/user-cards)
 * [View someone's profile](/help/view-someones-profile)
diff --git a/help/search-for-messages.md b/help/search-for-messages.md
index 69cefedd53..719ec2af7b 100644
--- a/help/search-for-messages.md
+++ b/help/search-for-messages.md
@@ -182,5 +182,6 @@ A summary of the search filters above is available in the Zulip app.
 ## Related articles
 
 * [Configure multi-language search](/help/configure-multi-language-search)
+* [Search people](/help/user-list#search-people)
 * [Link to a message or
   conversation](/help/link-to-a-message-or-conversation#link-to-zulip-from-anywhere)
diff --git a/help/user-list.md b/help/user-list.md
new file mode 100644
index 0000000000..26c743faea
--- /dev/null
+++ b/help/user-list.md
@@ -0,0 +1,59 @@
+# User list
+
+In the Zulip web and desktop app, the right sidebar shows a list of users in
+your organization. It shows
+[non-deactivated](/help/deactivate-or-reactivate-a-user) users, and does not
+include [bots](/help/bots-overview).
+
+In organizations with up to 600 users, everyone is shown. In larger organizations,
+only users who have been active in the last two weeks are listed. All users are
+included when you search for people.
+
+When you view a stream or a topic within a stream, subscribers to that stream
+are shown separately from other members of your organization. To avoid
+distraction, you can hide the user list any time.
+
+## Search people
+
+{start_tabs}
+
+{tab|desktop-web}
+
+1. If the user list in the right sidebar is hidden, click the **user list** (<i
+class="zulip-icon zulip-icon-triple-users"></i> ) icon in the upper right to
+show it.
+
+1. Click the **search** (<i class="search_icon zulip-icon
+   zulip-icon-search"></i>) icon at the top of the right sidebar to open the
+   search box.
+
+1. Type the name of the user you are looking for.
+
+!!! keyboard_tip ""
+
+    You can also use the <kbd>W</kbd> keyboard shortcut to start searching for
+    a person.
+
+{end_tabs}
+
+## Show or hide the user list
+
+{start_tabs}
+
+{tab|desktop-web}
+
+1. Click the **user list** (<i class="zulip-icon zulip-icon-triple-users"></i>
+) icon in the upper right.
+
+!!! keyboard_tip ""
+
+    The <kbd>W</kbd> keyboard shortcut to search people reveals the user list if
+    it is hidden.
+
+{end_tabs}
+
+## Related articles
+
+- [View someone's profile](/help/view-someones-profile)
+- [Status and availability](/help/status-and-availability)
+- [Searching for messages](/help/search-for-messages)