diff --git a/doc/user/discussions/img/index_notes_filters.png b/doc/user/discussions/img/index_notes_filters.png new file mode 100644 index 00000000000..977a3770c05 Binary files /dev/null and b/doc/user/discussions/img/index_notes_filters.png differ diff --git a/doc/user/discussions/index.md b/doc/user/discussions/index.md index 097b18ad496..0f89d261ff6 100644 --- a/doc/user/discussions/index.md +++ b/doc/user/discussions/index.md @@ -273,6 +273,26 @@ edit existing comments. Non-team members are restricted from adding or editing c Additionally locked issues can not be reopened. +## Filtering notes + +> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/26723) in GitLab 11.5. + +For issues with many comments like activity notes and user comments, sometimes +finding useful information can be hard. There is a way to filter comments from single notes and discussions for merge requests and issues. + +From a merge request's **Discussion** tab, or from an issue overview, find the filter's dropdown menu on the right side of the page, from which you can choose one of the following options: + +- **Show all activity**: displays all user comments and system notes +(issue updates, mentions from other issues, changes to the description, etc). +- **Show comments only**: only displays user comments in the list. +- **Show history only**: only displays activity notes. + +![Notes filters dropdown options](img/index_notes_filters.png) + +Once you select one of the filters in a given issue or MR, GitLab will save +your preference, so that it will persist when you visit the same page again +from any device you're logged into. + [ce-5022]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/5022 [ce-7125]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/7125 [ce-7527]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/7527