Merge branch 'search-filter-issues' into 'master'

Refactor filter Jira issues

See merge request https://gitlab.com/gitlab-org/gitlab/-/merge_requests/144440



Merged-by: Jon Glassman <jglassman@gitlab.com>
Approved-by: Bojan Marjanovic <bmarjanovic@gitlab.com>
Approved-by: Jon Glassman <jglassman@gitlab.com>
Co-authored-by: Ashraf Khamis <akhamis@gitlab.com>

doc/integration/jira/configure.md

@@ -67,7 +67,7 @@ To configure your project settings in GitLab:
    - For **Jira issue regex**, [enter a regex pattern](issues.md#define-a-regex-pattern).
    - For **Jira issue prefix**, [enter a prefix](issues.md#define-a-prefix).
 1. Optional. In the **Issues** section:
-   - To [view issues](#view-jira-issues) from a single Jira project in a GitLab project:
+   - To [view Jira issues](#view-jira-issues) in GitLab:
      1. Select the **Enable Jira issues** checkbox.
      1. Enter the Jira project key.
 
@@ -106,8 +106,7 @@ To view issues from a single Jira project in a GitLab project:
 
 By default, the issues are sorted by **Created date**.
 The most recently created issues appear at the top.
-You can [search and filter the issue list](issues.md#search-and-filter-the-issue-list)
-and select an issue to view that issue in GitLab.
+You can [filter issues](#filter-jira-issues) and select an issue to view that issue in GitLab.
 
 Issues are grouped into the following tabs based on their
 [Jira status](https://confluence.atlassian.com/adminjiraserver070/defining-status-field-values-749382903.html):
@@ -116,6 +115,31 @@ Issues are grouped into the following tabs based on their
 - **Closed**: issues with a **Done** Jira status.
 - **All**: issues with any Jira status.
 
+### Filter Jira issues
+
+DETAILS:
+**Tier:** Premium, Ultimate
+**Offering:** SaaS, self-managed
+
+Prerequisites:
+
+- Ensure the Jira issue integration is [configured](#configure-the-integration)
+  and the **Enable Jira issues** checkbox is selected.
+
+When you [view Jira issues](#view-jira-issues) in GitLab,
+you can filter the issues by text in summaries and descriptions.
+You can also filter the issues by:
+
+- **Label**: specify one or more Jira issue labels in the `labels[]` parameter in the URL.
+  When you specify multiple labels, only the issues that have all the specified labels appear
+  (for example, `/-/integrations/jira/issues?labels[]=backend&labels[]=feature&labels[]=QA`).
+- **Status**: specify the Jira issue status in the `status` parameter in the URL
+  (for example, `/-/integrations/jira/issues?status=In Progress`).
+- **Reporter**: specify the Jira display name of the `author_username` parameter in the URL
+  (for example, `/-/integrations/jira/issues?author_username=John Smith`).
+- **Assignee**: specify the Jira display name of the `assignee_username` parameter in the URL
+  (for example, `/-/integrations/jira/issues?assignee_username=John Smith`).
+
 ## Create a Jira issue for a vulnerability
 
 DETAILS:

doc/integration/jira/issues.md

@@ -146,29 +146,6 @@ Consider this example:
    - GitLab adds a formatted comment to Jira, linking back to the commit that
      resolved the issue. You can [disable comments](#disable-comments-on-jira-issues).
 
-## Search and filter the issue list
-
-DETAILS:
-**Tier:** Premium, Ultimate
-**Offering:** SaaS, self-managed
-
-To refine the list of issues, use the search bar to search for any text
-contained in an issue summary (title) or description. Use any combination
-of these filters:
-
-- To filter issues by `labels`, specify one or more labels as part of the `labels[]`
-  parameter in the URL. When using multiple labels, only issues that contain all specified
-  labels are listed: `/-/integrations/jira/issues?labels[]=backend&labels[]=feature&labels[]=QA`
-- To filter issues by `status`, specify the `status` parameter in the URL:
-  `/-/integrations/jira/issues?status=In Progress`
-- To filter issues by `reporter`, specify a reporter's Jira display name for the
-  `author_username` parameter in the URL: `/-/integrations/jira/issues?author_username=John Smith`
-- To filter issues by `assignee`, specify their Jira display name for the
-  `assignee_username` parameter in the URL: `/-/integrations/jira/issues?assignee_username=John Smith`
-
-Enhancements to use these filters through the user interface
-[are planned](https://gitlab.com/groups/gitlab-org/-/epics/3622).
-
 ## Automatic issue transitions
 
 When you configure automatic issue transitions, you can transition a referenced