Document about Breaking Changes in the docs.

Fix documentation of download_media

Author: SpEcHiDe

docs/source/releases/changes-in-this-fork.rst

@@ -14,6 +14,7 @@ If you found any issue or have any suggestions, feel free to make `an issue <htt
 Breaking Changes
 =================
 
+- PR `#115 <https://github.com/TelegramPlayGround/pyrogram/pull/115>`_ This `change <https://github.com/pyrogram/pyrogram/pull/966#issuecomment-1108858881>`_ breaks some usages with offset-naive and offset-aware datetimes.
 - PR from upstream: `1411 <https://github.com/pyrogram/pyrogram/pull/1411>`_ without attribution.
 
 Changes in this Fork

pyrogram/methods/messages/download_media.py

@@ -91,7 +91,8 @@ async def download_media(
             Otherwise, in case ``in_memory=True``, a binary file-like object with its attribute ".name" set is returned.
 
         Raises:
-            ValueError: if the message doesn't contain any downloadable media
+            RPCError: In case of a Telegram RPC error.
+            ValueError: If the message doesn't contain any downloadable media.
 
         Example:
             Download media to file

pyrogram/types/messages_and_media/message.py

@@ -5347,11 +5347,15 @@ async def download(
                 You can either keep ``*args`` or add every single extra argument in your function signature.
 
         Returns:
-            On success, the absolute path of the downloaded file as string is returned, None otherwise.
+            ``str`` | ``None`` | ``BinaryIO``: On success, the absolute path of the downloaded file is returned,
+            otherwise, in case the download failed or was deliberately stopped with
+            :meth:`~pyrogram.Client.stop_transmission`, None is returned.
+            Otherwise, in case ``in_memory=True``, a binary file-like object with its attribute ".name" set is returned.
 
         Raises:
             RPCError: In case of a Telegram RPC error.
-            ``ValueError``: If the message doesn't contain any downloadable media
+            ValueError: If the message doesn't contain any downloadable media.
+
         """
         return await self._client.download_media(
             message=self,