diff options
Diffstat (limited to 'doc/user/search/index.md')
| -rw-r--r-- | doc/user/search/index.md | 63 |
1 files changed, 17 insertions, 46 deletions
diff --git a/doc/user/search/index.md b/doc/user/search/index.md index 325e5386417..aa4950cfa33 100644 --- a/doc/user/search/index.md +++ b/doc/user/search/index.md @@ -5,26 +5,20 @@ info: "To determine the technical writer assigned to the Stage/Group associated type: index, reference, howto --- -# Search through GitLab **(FREE)** +# Searching in GitLab **(FREE)** -## Issues and merge requests +## Search issues and merge requests -To search through issues and merge requests in multiple projects, use the **Issues** or **Merge Requests** links -in the top-right part of your screen. These instructions are valid for both. +To search through issues and merge requests in multiple projects, on the top bar, select the **Issues** or **Merge Requests** links. -The numbers in the right-hand side of the top menu indicate how many issues, merge requests, -and to-do items are assigned to you: +The numbers indicate how many issues, merge requests, and to-do items are assigned to you: - + - **{issues}** **Issues**: The open issues assigned to you. - **{merge-request-open}** **Merge requests**: The [merge requests](../project/merge_requests/index.md) assigned to you. - **{todo-done}** **To-do items**: The [to-do items](../todos.md) assigned to you. -When you click **Issues**, GitLab shows the opened issues assigned to you: - - - You can search through **Open**, **Closed**, or **All** issues. You can also filter the results using the search and filter field, as described in @@ -35,7 +29,7 @@ You can also filter the results using the search and filter field, as described GitLab shows shortcuts to issues and merge requests created by you or assigned to you in the search field in the upper right corner: - + ### Filter issue and merge request lists @@ -63,25 +57,13 @@ groups: - `=`: Is - `!=`: Is not ([Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/18059) in GitLab 12.7) 1. Enter the text to [filter the attribute by](#filters-autocomplete). + You can filter some attributes by **None** or **Any**. 1. Repeat this process to filter by multiple attributes. Multiple attributes are joined by a logical - `AND`. For example, filtering by an Author and Milestone `!=` 12.6 filters for the issues where the - author matches your selection, and the milestone is not 12.6: - -  + `AND`. GitLab displays the results on-screen, but you can also [retrieve them as an RSS feed](#retrieve-search-results-as-feed). -### Filtering by **None** / **Any** - -Some filter fields like milestone and assignee, allow you to filter by **None** or **Any**. - - - -Selecting **None** returns results that have an empty value for that field. For example: no milestone, no assignee. - -Selecting **Any** does the opposite. It returns results that have a non-empty value for that field. - ### Searching for specific terms You can filter issues and merge requests by specific terms included in titles or descriptions. @@ -95,8 +77,6 @@ You can filter issues and merge requests by specific terms included in titles or issues for `included in titles` is same as `included titles` - Search is limited to 4096 characters and 64 terms per query. - - ### Retrieve search results as feed > Feeds for merge requests were [introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/66336) in GitLab 14.3. @@ -128,7 +108,7 @@ You can filter the **Issues** list to individual instances by their ID. For exam To filter merge requests by an individual approver, you can type (or select from the dropdown) **Approver** and select the user. - + ### Filtering merge requests by "approved by" **(PREMIUM)** @@ -138,7 +118,7 @@ the dropdown) **Approver** and select the user. To filter merge requests already approved by a specific individual, you can type (or select from the dropdown) **Approved-By** and select the user. - + ### Filtering merge requests by reviewer **(FREE)** @@ -161,13 +141,15 @@ you can type (or select from the dropdown) the following: When filtering by an environment, a dropdown presents all environments that you can choose from: - + -When filtering by a deploy date, you must enter the date manually. Deploy dates +When filtering by `Deployed-before` or `Deployed-after`, the date refers to when +the deployment to an environment (triggered by the merge commit) completed successfully. +You must enter the deploy date manually. Deploy dates use the format `YYYY-MM-DD`, and must be quoted if you wish to specify both a date and time (`"YYYY-MM-DD HH:MM"`): - + ## Filters autocomplete @@ -245,20 +227,9 @@ and **Labels**, select multiple issues to add to a list of your choice:  -## Shortcut - -To view issues and merge requests created or assigned to you in a project: - -1. Go to your project. -1. In the top navigation bar, click the search box to display a list of issues and - merge requests. -1. Select your desired issue or merge request: - -  - -### Autocomplete suggestions +## Autocomplete suggestions -You can also type in this search bar to see autocomplete suggestions for: +In the search bar, you can view autocomplete suggestions for: - Projects and groups - Various help pages (try and type **API help**) |