From fd5dea4e340e69cd2527114283d8c06b2396689b Mon Sep 17 00:00:00 2001
From: Stocker <44980366+StockerMC@users.noreply.github.com>
Date: Tue, 15 Mar 2022 23:33:11 -0400
Subject: [PATCH] Update Permissions.stage_moderator

---
 discord/permissions.py | 13 ++++++++++---
 docs/migrating.rst     |  2 ++
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/discord/permissions.py b/discord/permissions.py
index e2b053b29..da9679df9 100644
--- a/discord/permissions.py
+++ b/discord/permissions.py
@@ -231,12 +231,19 @@ class Permissions(BaseFlags):
 
     @classmethod
     def stage_moderator(cls) -> Self:
-        """A factory method that creates a :class:`Permissions` with all
-        "Stage Moderator" permissions from the official Discord UI set to ``True``.
+        """A factory method that creates a :class:`Permissions` with all permissions
+        for stage moderators set to ``True``. These permissions are currently:
+
+        - :attr:`manage_channels`
+        - :attr:`mute_members`
+        - :attr:`move_members`
 
         .. versionadded:: 1.7
+
+        .. versionchanged:: 2.0
+            Added :attr:`manage_channels` permission and removed :attr:`request_to_speak` permission.
         """
-        return cls(0b100000001010000000000000000000000)
+        return cls(0b1010000000000000000010000)
 
     @classmethod
     def advanced(cls) -> Self:
diff --git a/docs/migrating.rst b/docs/migrating.rst
index e1a105f00..12611a8a9 100644
--- a/docs/migrating.rst
+++ b/docs/migrating.rst
@@ -1156,6 +1156,8 @@ The following changes have been made:
 - :meth:`Message.edit` now merges object passed in ``allowed_mentions`` parameter with :attr:`Client.allowed_mentions`.
   If the parameter isn't provided, the defaults given by :attr:`Client.allowed_mentions` are used instead.
 
+- :meth:`Permissions.stage_moderator` now includes the :attr:`Permissions.manage_channels` permission and the :attr:`Permissions.request_to_speak` permission is no longer included.
+
 .. _migrating_2_0_commands:
 
 Command Extension Changes