From 82a98a5c65a021acbc615f0f71c80e47df66be73 Mon Sep 17 00:00:00 2001
From: Madelein van Niekerk <mvanniekerk@gitlab.com>
Date: Wed, 5 Mar 2025 11:29:46 +0200
Subject: [PATCH] Update user documentation for user autocomplete

---
 doc/user/search/_index.md | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/doc/user/search/_index.md b/doc/user/search/_index.md
index 40376a369136e..65cd7db2085d6 100644
--- a/doc/user/search/_index.md
+++ b/doc/user/search/_index.md
@@ -126,10 +126,23 @@ However, the query matches all possible variations of the string (for example, `
 
 ## Autocomplete suggestions
 
+{{< history >}}
+
+- Showing only users from authorized projects and groups [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/442091) in GitLab 17.10 [with flags](../../administration/feature_flags.md) named `users_search_scoped_to_authorized_namespaces_advanced_search` and `users_search_scoped_to_authorized_namespaces_basic_search`. Disabled by default.
+
+{{< /history >}}
+
+{{< alert type="flag" >}}
+
+The availability of this feature is controlled by feature flags.
+For more information, see the history.
+
+{{< /alert >}}
+
 As you type in the search box, autocomplete suggestions are displayed for:
 
 - [Projects](#search-for-a-project-by-full-path) and groups
-- Users
+- Users from authorized projects and groups
 - Help pages
 - Project features (for example, milestones)
 - Settings (for example, user settings)
-- 
GitLab