Update add_roles docstring to mention role order.

manubernat · Jan 14, 2021 · bbbda4e · bbbda4e
1 parent f78f135
commit bbbda4e
Showing 1 changed file with 4 additions and 2 deletions.
diff --git a/discord/member.py b/discord/member.py
@@ -643,7 +643,8 @@ async def add_roles(self, *roles, reason=None, atomic=True):
         Gives the member a number of :class:`Role`\s.
 
         You must have the :attr:`~Permissions.manage_roles` permission to
-        use this.
+        use this, and the added :class:`Role`\s must appear lower in the list
+        of roles than the highest role of the member.
 
         Parameters
         -----------
@@ -681,7 +682,8 @@ async def remove_roles(self, *roles, reason=None, atomic=True):
         Removes :class:`Role`\s from this member.
 
         You must have the :attr:`~Permissions.manage_roles` permission to
-        use this.
+        use this, and the removed :class:`Role`\s must appear lower in the list
+        of roles than the highest role of the member.
 
         Parameters
         -----------