From 99daa74b002bdd1182d6f0e28a2ac549981a4e6b Mon Sep 17 00:00:00 2001
From: "Babak K. Shandiz" <babakks@github.com>
Date: Sun, 31 Aug 2025 15:35:17 +0100
Subject: [PATCH] docs(search issues): mention advanced issue search takeover

Signed-off-by: Babak K. Shandiz <babakks@github.com>
---
 pkg/cmd/search/issues/issues.go | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/pkg/cmd/search/issues/issues.go b/pkg/cmd/search/issues/issues.go
index 1d6ec6428..845cc7c60 100644
--- a/pkg/cmd/search/issues/issues.go
+++ b/pkg/cmd/search/issues/issues.go
@@ -35,6 +35,10 @@ func NewCmdIssues(f *cmdutil.Factory, runF func(*shared.IssuesOptions) error) *c
 			GitHub search syntax is documented at:
 			<https://docs.github.com/search-github/searching-on-github/searching-issues-and-pull-requests>
 
+			When runs against %[1]sgithub.com%[1]s or GHE versions newer than 3.17.x,
+			the command performs advanced issue search. The advanced syntax is documented at:
+			<https://github.blog/changelog/2025-03-06-github-issues-projects-api-support-for-issues-advanced-search-and-more>
+
 			For more information on handling search queries containing a hyphen, run %[1]sgh search --help%[1]s.
 		`, "`"),
 		Example: heredoc.Doc(`