From 765924a3a4cda6bce843b28f3453dd87df43b105 Mon Sep 17 00:00:00 2001
From: Aine Riordan <44700011+ariordan-redhat@users.noreply.github.com>
Date: Fri, 29 Oct 2021 13:01:21 -0700
Subject: [PATCH] Add reminder about groups default behavior in user module
 (#76096)

---
 lib/ansible/modules/user.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/ansible/modules/user.py b/lib/ansible/modules/user.py
index 6d22a5f41cf..c129328968d 100644
--- a/lib/ansible/modules/user.py
+++ b/lib/ansible/modules/user.py
@@ -53,7 +53,9 @@ options:
         type: str
     groups:
         description:
-            - List of groups user will be added to. When set to an empty string C(''),
+            - List of groups user will be added to.
+            - By default, the user is removed from all other groups. Configure C(append) to modify this.
+            - When set to an empty string C(''),
               the user is removed from all groups except the primary group.
             - Before Ansible 2.3, the only input format allowed was a comma separated string.
         type: list