From 1416096527be9fc7edf29a087515f0ac62ce8419 Mon Sep 17 00:00:00 2001
From: Tejaswini Gurram <47633397+tjay27@users.noreply.github.com>
Date: Fri, 13 Jan 2023 20:16:21 +0530
Subject: [PATCH] Update misleading documentation `
 user_directory.search_all_users ` (#14818)

Fixes #13852
---
 changelog.d/14818.doc                            | 1 +
 docs/usage/configuration/config_documentation.md | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)
 create mode 100644 changelog.d/14818.doc

diff --git a/changelog.d/14818.doc b/changelog.d/14818.doc
new file mode 100644
index 0000000000..7a47cc8ab3
--- /dev/null
+++ b/changelog.d/14818.doc
@@ -0,0 +1 @@
+Updated documentation in configuration manual for `user_directory.search_all_users`.
\ No newline at end of file
diff --git a/docs/usage/configuration/config_documentation.md b/docs/usage/configuration/config_documentation.md
index 35de9c95e3..3481e866f7 100644
--- a/docs/usage/configuration/config_documentation.md
+++ b/docs/usage/configuration/config_documentation.md
@@ -3472,8 +3472,8 @@ This setting defines options related to the user directory.
 This option has the following sub-options:
 * `enabled`:  Defines whether users can search the user directory. If false then
    empty responses are returned to all queries. Defaults to true.
-* `search_all_users`: Defines whether to search all users visible to your HS when searching
-   the user directory. If false, search results will only contain users
+* `search_all_users`: Defines whether to search all users visible to your HS at the time the search is performed. If set to true, will return all users who share a room with the user from the homeserver.
+   If false, search results will only contain users
     visible in public rooms and users sharing a room with the requester.
     Defaults to false.