From 5747297775c34ffa1a214822e0c748e6bc50e968 Mon Sep 17 00:00:00 2001
From: "Babak K. Shandiz" <babakks@github.com>
Date: Mon, 1 Sep 2025 13:40:20 +0100
Subject: [PATCH] docs(issue list): explain use of advanced issue search syntax

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

diff --git a/pkg/cmd/issue/list/list.go b/pkg/cmd/issue/list/list.go
index 241fbee02..2dea7dceb 100644
--- a/pkg/cmd/issue/list/list.go
+++ b/pkg/cmd/issue/list/list.go
@@ -61,6 +61,11 @@ func NewCmdList(f *cmdutil.Factory, runF func(*ListOptions) error) *cobra.Comman
 		Long: heredoc.Doc(`
 			List issues in a GitHub repository. By default, this only lists open issues.
 
+			When runs against %[1]sgithub.com%[1]s or GHE versions newer than 3.17.x,
+			the command performs search by using the advanced issue search syntax, which
+			is documented at:
+			<https://github.blog/changelog/2025-03-06-github-issues-projects-api-support-for-issues-advanced-search-and-more>
+
 			The search query syntax is documented here:
 			<https://docs.github.com/en/search-github/searching-on-github/searching-issues-and-pull-requests>
 		`),