From 6def475fc4707a55d8020b82a216a23c12cdba73 Mon Sep 17 00:00:00 2001
From: Leni Kadali <lenikadali@noreply.codeberg.org>
Date: Thu, 11 Jun 2026 06:59:40 +0200
Subject: [PATCH] feat(ui): mention quote searching and search docs in search
 syntax popup (#12966)

Fixes [#12505](https://codeberg.org/forgejo/forgejo/issues/12505).
Also see [this comment](https://codeberg.org/forgejo/forgejo/issues/12505#issuecomment-15410954) on the issue as well.

## Preview

![](https://codeberg.org/attachments/4e1a85e8-755d-4137-85a3-60ab193bc919)

Reviewed-on: https://codeberg.org/forgejo/forgejo/pulls/12966
Reviewed-by: 0ko <0ko@noreply.codeberg.org>
---
 options/locale_next/locale_en-US.json     | 2 ++
 templates/shared/search/issue/syntax.tmpl | 4 +++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/options/locale_next/locale_en-US.json b/options/locale_next/locale_en-US.json
index d21c32162c..3eb680af6d 100644
--- a/options/locale_next/locale_en-US.json
+++ b/options/locale_next/locale_en-US.json
@@ -134,6 +134,8 @@
 	"search.syntax": "Search syntax",
 	"search.fuzzy": "Fuzzy",
 	"search.fuzzy_tooltip": "Include results is an approximate match to the search term",
+	"search.match_inside_quotes": "Include only results that match the term in quotes",
+	"search.docs": "<a target=\"_blank\" rel=\"noopener noreferrer\" href=\"%[1]s\">See the documentation</a> for further details on search, operators, and filters.",
 	"repo.settings.push_mirror.branch_filter.label": "Branch filter (optional)",
 	"repo.settings.push_mirror.branch_filter.description": "Branches to be mirrored. Leave blank to mirror all branches. See <a href=\"%[1]s\">%[2]s documentation</a> for syntax. Examples: <code>main, release/*</code>",
 	"repo.settings.units.more_units_disable_hint": "The \"Enable more\" hint can be disabled in <a href=\"%s\">User settings > Appearance</a>.",
diff --git a/templates/shared/search/issue/syntax.tmpl b/templates/shared/search/issue/syntax.tmpl
index 76e6ef2638..f446bbcf0e 100644
--- a/templates/shared/search/issue/syntax.tmpl
+++ b/templates/shared/search/issue/syntax.tmpl
@@ -15,13 +15,15 @@
 							"review:<username>" (ctx.Locale.TrString "repo.issues.filter_reviewers.hint")
 							"mentions:<username>" (ctx.Locale.TrString "repo.issues.filter_mention.hint")
 							"sort:<by>:[asc|desc]" (ctx.Locale.Tr "repo.issues.filter_sort.hint_with_placeholder" (HTMLFormat "<code>created|comments|updated|deadline</code>"))
-							"modified:[>|<]<date>" (ctx.Locale.TrString "repo.issues.filter_modified.hint")}}
+							"modified:[>|<]<date>" (ctx.Locale.TrString "repo.issues.filter_modified.hint")
+							"\"forgejo\"" (ctx.Locale.TrString "search.match_inside_quotes")}}
 						<tr>
 							<th class="tw-p-2"><code>{{$filter}}</code></th>
 							<td class="tw-p-2">{{$tr}}</td>
 						</tr>
 					{{end}}
 				</tbody>
+				{{ctx.Locale.Tr "search.docs" "https://forgejo.org/docs/latest/user/issue-search/"}}
 			</table>
 		</div>
 		<footer class="actions">