From 686f2339546ceb82b01f9f24e616774ad7b7d3f8 Mon Sep 17 00:00:00 2001
From: jack1142 <6032823+jack1142@users.noreply.github.com>
Date: Sun, 20 Feb 2022 04:35:52 +0100
Subject: [PATCH] Add missing information about in-place edits in Message.edit

---
 discord/message.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/discord/message.py b/discord/message.py
index 7aaa0aff5..6a5864f45 100644
--- a/discord/message.py
+++ b/discord/message.py
@@ -1218,6 +1218,9 @@ class Message(Hashable):
         .. versionchanged:: 1.3
             The ``suppress`` keyword-only parameter was added.
 
+        .. versionchanged:: 2.0
+            Edits are no longer in-place, the newly edited role is returned instead.
+
         Parameters
         -----------
         content: Optional[:class:`str`]
@@ -1271,6 +1274,11 @@ class Message(Hashable):
             edited a message's content or embed that isn't yours.
         ~discord.InvalidArgument
             You specified both ``embed`` and ``embeds``
+
+        Returns
+        --------
+        :class:`Message`
+            The newly edited message.
         """
 
         previous_allowed_mentions = self._state.allowed_mentions