fix: improve clarity of NSFW parameter documentation and slowmode for continiuty

Author: Lumabots

discord/channel.py

@@ -812,7 +812,7 @@ async def edit(self, *, reason=None, **options):
         position: :class:`int`
             The new channel's position.
         nsfw: :class:`bool`
-            To mark the channel as NSFW or not.
+            Whether the channel is marked as NSFW.
         sync_permissions: :class:`bool`
             Whether to sync permissions with the channel's new or pre-existing
             category. Defaults to ``False``.
@@ -1115,7 +1115,7 @@ async def edit(self, *, reason=None, **options):
         position: :class:`int`
             The new channel's position.
         nsfw: :class:`bool`
-            To mark the channel as NSFW or not.
+            Whether the channel is marked as NSFW.
         sync_permissions: :class:`bool`
             Whether to sync permissions with the channel's new or pre-existing
             category. Defaults to ``False``.
@@ -1478,7 +1478,7 @@ async def edit(self, *, reason=None, **options):
         position: :class:`int`
             The new channel's position.
         nsfw: :class:`bool`
-            To mark the channel as NSFW or not.
+            Whether the channel is marked as NSFW.
         sync_permissions: :class:`bool`
             Whether to sync permissions with the channel's new or pre-existing
             category. Defaults to ``False``.
@@ -1728,7 +1728,7 @@ class VoiceChannel(discord.abc.Messageable, VocalGuildChannel):
         .. versionadded:: 2.0
 
     nsfw: :class:`bool`
-        To mark the channel as NSFW or not.
+        Whether the channel is marked as NSFW.
 
         .. versionadded:: 2.7
     """
@@ -2102,10 +2102,10 @@ async def edit(self, *, reason=None, **options):
 
         slowmode_delay: :class:`int`
             Specifies the slowmode rate limit for user in this channel, in seconds.
-            The maximum value possible is `21600`.
+            A value of `0` disables slowmode. The maximum value possible is `21600`.
 
         nsfw: :class:`bool`
-            To mark the channel as NSFW or not.
+            Whether the channel is marked as NSFW.
 
             .. versionadded:: 2.7
 
@@ -2273,7 +2273,7 @@ class StageChannel(discord.abc.Messageable, VocalGuildChannel):
         The maximum value possible is `21600`.
 
     nsfw: :class:`bool`
-        To mark the channel as NSFW or not.
+        Whether the channel is marked as NSFW.
 
         .. versionadded:: 2.7
     """
@@ -2768,7 +2768,7 @@ async def edit(self, *, reason=None, **options):
 
         slowmode_delay: :class:`int`
             Specifies the slowmode rate limit for user in this channel, in seconds.
-            The maximum value possible is `21600`.
+            A value of `0` disables slowmode. The maximum value possible is `21600`.
 
         Returns
         -------
@@ -2856,8 +2856,7 @@ def __init__(
 
     def __repr__(self) -> str:
         return (
-            "<CategoryChannel"
-            f" id={self.id} name={self.name!r} position={self.position}"
+            f"<CategoryChannel id={self.id} name={self.name!r} position={self.position}"
         )
 
     def _update(self, guild: Guild, data: CategoryChannelPayload) -> None:

discord/guild.py

@@ -1168,9 +1168,9 @@ async def create_text_channel(
             The new channel's topic.
         slowmode_delay: :class:`int`
             Specifies the slowmode rate limit for user in this channel, in seconds.
-            The maximum value possible is `21600`.
+            A value of `0` disables slowmode. The maximum value possible is `21600`.
         nsfw: :class:`bool`
-            To mark the channel as NSFW or not.
+            Whether the channel is marked as NSFW.
         reason: Optional[:class:`str`]
             The reason for creating this channel. Shows up on the audit log.
 
@@ -1302,12 +1302,12 @@ async def create_voice_channel(
 
         slowmode_delay: :class:`int`
             Specifies the slowmode rate limit for user in this channel, in seconds.
-            The maximum value possible is `21600`.
+            A value of `0` disables slowmode. The maximum value possible is `21600`.
 
             .. versionadded:: 2.7
 
         nsfw: :class:`bool`
-            To mark the channel as NSFW or not.
+            Whether the channel is marked as NSFW.
 
             .. versionadded:: 2.7
 
@@ -1424,12 +1424,12 @@ async def create_stage_channel(
 
         slowmode_delay: :class:`int`
             Specifies the slowmode rate limit for user in this channel, in seconds.
-            The maximum value possible is `21600`.
+            A value of `0` disables slowmode. The maximum value possible is `21600`.
 
             .. versionadded:: 2.7
 
         nsfw: :class:`bool`
-            To mark the channel as NSFW or not.
+            Whether the channel is marked as NSFW.
 
             .. versionadded:: 2.7
 
@@ -1538,9 +1538,9 @@ async def create_forum_channel(
             The new channel's topic.
         slowmode_delay: :class:`int`
             Specifies the slowmode rate limit for user in this channel, in seconds.
-            The maximum value possible is `21600`.
+            A value of `0` disables slowmode. The maximum value possible is `21600`.
         nsfw: :class:`bool`
-            To mark the channel as NSFW or not.
+            Whether the channel is marked as NSFW.
         reason: Optional[:class:`str`]
             The reason for creating this channel. Shows up on the audit log.
         default_reaction_emoji: Optional[:class:`GuildEmoji` | :class:`int` | :class:`str`]