[docs] Update Sphinx and Fix various references

Co-Authored-By: Riley Shaw <[email protected]>

discord/abc.py

@@ -1043,7 +1043,7 @@ class GuildChannel:
             invite.
         reason: Optional[:class:`str`]
             The reason for creating this invite. Shows up on the audit log.
-        target_type: Optional[:class:`InviteTarget`]
+        target_type: Optional[:class:`.InviteTarget`]
             The type of target for the voice channel invite, if any.
             
             .. versionadded:: 2.0

discord/appinfo.py

@@ -196,7 +196,7 @@ class AppInfo:
         return self._state._get_guild(self.guild_id)
 
 class PartialAppInfo:
-    """Represents a partial AppInfo given by :func:`~GuildChannel.create_invite`
+    """Represents a partial AppInfo given by :func:`~discord.abc.GuildChannel.create_invite`
 
     .. versionadded:: 2.0
 

discord/channel.py

@@ -1083,7 +1083,7 @@ class StageChannel(VocalGuildChannel):
         topic: :class:`str`
             The stage instance's topic.
         privacy_level: :class:`StagePrivacyLevel`
-            The stage instance's privacy level. Defaults to :attr:`PrivacyLevel.guild_only`.
+            The stage instance's privacy level. Defaults to :attr:`StagePrivacyLevel.guild_only`.
 
         Raises
         ------

discord/client.py

@@ -706,7 +706,7 @@ class Client:
 
         Returns
         --------
-        Optional[:class:`StageInstance`]
+        Optional[:class:`.StageInstance`]
             The returns stage instance of ``None`` if not found.
         """
         from .channel import StageChannel
@@ -1162,7 +1162,7 @@ class Client:
     async def fetch_stage_instance(self, channel_id: int) -> StageInstance:
         """|coro|
 
-        Gets a :class:`StageInstance` for a stage channel id.
+        Gets a :class:`.StageInstance` for a stage channel id.
 
         .. versionadded:: 2.0
 
@@ -1180,7 +1180,7 @@ class Client:
 
         Returns
         --------
-        :class:`StageInstance`
+        :class:`.StageInstance`
             The stage instance from the stage channel ID.
         """
         data = await self.http.get_stage_instance(channel_id)
@@ -1466,5 +1466,5 @@ class Client:
 
     @property
     def persistent_views(self) -> Sequence[View]:
-        """Sequence[:class:`View`]: A sequence of persistent views added to the client."""
+        """Sequence[:class:`.View`]: A sequence of persistent views added to the client."""
         return self._connection.persistent_views

discord/components.py

@@ -136,7 +136,7 @@ class Button(Component):
 
     Attributes
     -----------
-    style: :class:`ComponentButtonStyle`
+    style: :class:`.ButtonStyle`
         The style of the button.
     custom_id: Optional[:class:`str`]
         The ID of the button that gets received during an interaction.

discord/ui/button.py

@@ -65,7 +65,7 @@ class Button(Item[V]):
         Whether the button is disabled or not.
     label: Optional[:class:`str`]
         The label of the button, if any.
-    emoji: Optional[Union[:class:`PartialEmoji`, :class:`Emoji`, :class:`str`]]
+    emoji: Optional[Union[:class:`.PartialEmoji`, :class:`.Emoji`, :class:`str`]]
         The emoji of the button, if available.
     row: Optional[:class:`int`]
         The relative row this button belongs to. A Discord component can only have 5
@@ -180,7 +180,7 @@ class Button(Item[V]):
 
     @property
     def emoji(self) -> Optional[PartialEmoji]:
-        """Optional[:class:`PartialEmoji`]: The emoji of the button, if available."""
+        """Optional[:class:`.PartialEmoji`]: The emoji of the button, if available."""
         return self._underlying.emoji
 
     @emoji.setter
@@ -251,13 +251,13 @@ def button(
     custom_id: Optional[:class:`str`]
         The ID of the button that gets received during an interaction.
         It is recommended not to set this parameter to prevent conflicts.
-    style: :class:`ButtonStyle`
+    style: :class:`.ButtonStyle`
-        The style of the button. Defaults to :attr:`ButtonStyle.grey`.
+        The style of the button. Defaults to :attr:`.ButtonStyle.grey`.
     disabled: :class:`bool`
         Whether the button is disabled or not. Defaults to ``False``.
-    emoji: Optional[Union[:class:`str`, :class:`Emoji`, :class:`PartialEmoji`]]
+    emoji: Optional[Union[:class:`str`, :class:`.Emoji`, :class:`.PartialEmoji`]]
-        The emoji of the button. This can be in string form or a :class:`PartialEmoji`
+        The emoji of the button. This can be in string form or a :class:`.PartialEmoji`
-        or a full :class:`Emoji`.
+        or a full :class:`.Emoji`.
     row: Optional[:class:`int`]
         The relative row this button belongs to. A Discord component can only have 5
         rows. By default, items are arranged automatically into those 5 rows. If you'd

discord/ui/item.py

@@ -123,7 +123,7 @@ class Item(Generic[V]):
 
         Parameters
         -----------
-        interaction: :class:`Interaction`
+        interaction: :class:`.Interaction`
             The interaction that triggered this UI item.
         """
         pass

docs/_static/style.css

@@ -772,8 +772,7 @@ li > blockquote {
 
 /* admonitions */
 div.admonition {
-  padding: 0 0.8em;
+  padding: 0 0.8em 0.8em 0.8em !important;
-  padding-bottom: 0.8em;
   margin: 0.8em 0;
   border-radius: 2.5px;
   border-left-width: 6px;
@@ -783,7 +782,7 @@ div.admonition {
 
 p.admonition-title {
   font-weight: bold;
-  margin: 0 -0.8rem;
+  margin: 0 -0.8rem !important;
   padding: 0.4rem 0.6rem 0.4rem 2.5rem;
   position: relative;
   -moz-user-select: none;
@@ -1142,6 +1141,10 @@ table.docutils tbody tr td ol.last {
   margin-bottom: 0;
 }
 
+.align-default {
+  text-align: left !important;
+}
+
 /* hide the welcome text */
 section#welcome-to-discord-py > h1 {
   display: none;

docs/api.rst

@@ -2236,7 +2236,7 @@ of :class:`enum.Enum`.
 
     .. attribute:: remove_role
 
-        This will remove the :attr:`Integration.role` from the user
+        This will remove the :attr:`StreamIntegration.role` from the user
         when their subscription is finished.
 
     .. attribute:: kick

setup.py

@@ -36,7 +36,7 @@ with open('README.rst') as f:
 extras_require = {
     'voice': ['PyNaCl>=1.3.0,<1.5'],
     'docs': [
-        'sphinx==3.5.4',
+        'sphinx==4.0.2',
         'sphinxcontrib_trio==1.1.2',
         'sphinxcontrib-websupport',
     ]