From a4271053f8fe3f67f20ba43d058b3a2c79feb8da Mon Sep 17 00:00:00 2001
From: Nilanka De Silva <ndesilva@gitlab.com>
Date: Mon, 30 Sep 2024 13:57:00 +0000
Subject: [PATCH] Apply 1 suggestion(s) to 1 file(s)

Co-authored-by: Brendan Lynch <blynch@gitlab.com>
---
 doc/user/project/merge_requests/approvals/rules.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/user/project/merge_requests/approvals/rules.md b/doc/user/project/merge_requests/approvals/rules.md
index 4990b0e58fa19..57e8d5a60a19d 100644
--- a/doc/user/project/merge_requests/approvals/rules.md
+++ b/doc/user/project/merge_requests/approvals/rules.md
@@ -207,7 +207,9 @@ To enable approval permissions for these users without granting them push access
 1. [Create a protected branch](../../repository/branches/protected.md)
 1. [Create a new group](../../../group/index.md#create-a-group).
 1. [Add the user to the group](../../../group/index.md#add-users-to-a-group),
-   and select the Reporter role for the user.
+   and select the Reporter role for the user. Do not assign roles with higher permissions than
+   Reporter due to a [known issue](https://gitlab.com/gitlab-org/gitlab/-/issues/492467).
+   Assigning higher roles may result in unexpected behavior.
 1. [Share the project with your group](../../members/sharing_projects_groups.md#invite-a-group-to-a-project),
    with at least the Reporter role.
 1. On the left sidebar, select **Search or go to** and find your project.
-- 
GitLab