docs: 📝 Fixes

discord/channel.py

@@ -2884,8 +2884,6 @@ class CategoryChannel(discord.abc.GuildChannel, Hashable):
         The position in the category list. This is a number that starts at 0. e.g. the
         top category is position 0. Can be ``None`` if the channel was received in an interaction.
 
-        .. note::
-
     flags: :class:`ChannelFlags`
         Extra features of the channel.
 

discord/client.py

@@ -553,6 +553,15 @@ async def on_view_error(
         The default view error handler provided by the client.
 
         This only fires for a view if you did not define its :func:`~discord.ui.View.on_error`.
+
+        Parameters
+        ----------
+        error: :class:`Exception`
+            The exception that was raised.
+        item: :class:`Item`
+            The item that the user interacted with.
+        interaction: :class:`Interaction`
+            The interaction that was received.
         """
 
         print(
@@ -570,6 +579,13 @@ async def on_modal_error(self, error: Exception, interaction: Interaction) -> No
         The default implementation prints the traceback to stderr.
 
         This only fires for a modal if you did not define its :func:`~discord.ui.Modal.on_error`.
+
+        Parameters
+        ----------
+        error: :class:`Exception`
+            The exception that was raised.
+        interaction: :class:`Interaction`
+            The interaction that was received.
         """
 
         print(f"Ignoring exception in modal {interaction.modal}:", file=sys.stderr)
@@ -1103,7 +1119,7 @@ def get_poll(self, id: int, /) -> Poll | None:
 
         Returns
         -------
-        Optional[:class:`.Poll`]
+        Optional[:class:`Poll`]
             The poll or ``None`` if not found.
         """
         return self._connection.get_poll(id)

discord/guild.py

@@ -175,8 +175,6 @@ class Guild(Hashable):
         The channel that denotes the AFK channel. ``None`` if it doesn't exist.
     id: :class:`int`
         The guild's ID.
-    invites_disabled: :class:`bool`
-        Indicates if the guild invites are disabled.
     owner_id: :class:`int`
         The guild owner's ID. Use :attr:`Guild.owner` instead.
     unavailable: :class:`bool`
@@ -1190,7 +1188,7 @@ def created_at(self) -> datetime.datetime:
 
     @property
     def invites_disabled(self) -> bool:
-        """Returns a boolean indicating if the guild invites are disabled."""
+        """A boolean indicating if the guild invites are disabled."""
         return "INVITES_DISABLED" in self.features
 
     def get_member_named(self, name: str, /) -> Member | None:

discord/raw_models.py

@@ -46,6 +46,7 @@
     from .soundboard import PartialSoundboardSound, SoundboardSound
     from .state import ConnectionState
     from .threads import Thread
+    from .types.channel import VoiceChannelEffectSendEvent as VoiceChannelEffectSend
     from .types.raw_models import (
         AuditLogEntryEvent,
     )
@@ -65,9 +66,6 @@
         ThreadMembersUpdateEvent,
         ThreadUpdateEvent,
         TypingEvent,
-    )
-    from .types.raw_models import VoiceChannelEffectSendEvent as VoiceChannelEffectSend
-    from .types.raw_models import (
         VoiceChannelStatusUpdateEvent,
     )
     from .user import User

docs/api/data_classes.rst

@@ -28,7 +28,7 @@ dynamic attributes in mind.
 
 .. attributetable:: MediaGalleryItem
 
-.. autoclass:: SelectOption
+.. autoclass:: MediaGalleryItem
     :members:
 
 .. attributetable:: UnfurledMediaItem

docs/api/enums.rst

@@ -2572,3 +2572,15 @@ of :class:`enum.Enum`.
     .. attribute:: large
 
         The separator uses large padding.
+
+.. class:: SortOrder
+
+    Used to represent the default sort order for posts in :class:`ForumChannel` and :class:`MediaChannel`.
+
+    .. attribute:: latest_activity
+
+        Sort by latest activity.
+
+    .. attribute:: creation_date
+
+        Sort by post creation date.

docs/api/models.rst

@@ -374,7 +374,7 @@ Interactions
     :members:
 
 Message Components
-------------
+------------------
 
 .. attributetable:: Component