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

@@ -69,7 +69,7 @@
 if TYPE_CHECKING:
     from .abc import GuildChannel, PrivateChannel, Snowflake, SnowflakeTime
     from .channel import DMChannel
-    from .interaction import Interaction
+    from .interactions import Interaction
     from .member import Member
     from .message import Message
     from .poll import Poll
@@ -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)

discord/components.py

@@ -743,7 +743,6 @@ def __str__(self) -> str:
 
     @property
     def url(self) -> str:
-        """Returns this media item's url."""
         return self._url
 
     @url.setter
@@ -850,7 +849,6 @@ def __init__(self, url, *, description=None, spoiler=False):
 
     @property
     def url(self) -> str:
-        """Returns the URL of this gallery's underlying media item."""
         return self.media.url
 
     def is_dispatchable(self) -> bool:

discord/guild.py

@@ -56,8 +56,10 @@
     EntitlementOwnerType,
     NotificationLevel,
     NSFWLevel,
+    OnboardingMode,
     ScheduledEventLocationType,
     ScheduledEventPrivacyLevel,
+    SortOrder,
     VerificationLevel,
     VideoQualityMode,
     VoiceRegion,
@@ -104,6 +106,7 @@
         TextChannel,
         VoiceChannel,
     )
+    from .onboarding import OnboardingPrompt
     from .permissions import Permissions
     from .state import ConnectionState
     from .template import Template
@@ -175,8 +178,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 +1191,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 whether the guild invites are disabled."""
         return "INVITES_DISABLED" in self.features
 
     def get_member_named(self, name: str, /) -> Member | None:
@@ -4509,7 +4510,7 @@ def entitlements(
             exclude_ended=exclude_ended,
         )
 
-    def get_sound(self, sound_id: int) -> Soundboard | None:
+    def get_sound(self, sound_id: int) -> SoundboardSound | None:
         """Returns a sound with the given ID.
 
         .. versionadded :: 2.7

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
 

docs/ext/bridge/api.rst

@@ -159,7 +159,7 @@ BridgeContext Subclasses
     Alias of :data:`typing.Union` [ :class:`.BridgeExtContext`, :class:`.BridgeApplicationContext` ] for typing convenience.
 
 Options
-------
+-------
 
 Shortcut Decorators
 ~~~~~~~~~~~~~~~~~~~