From 06a29e599726dea21beb4e8e5914cf9540f70ccd Mon Sep 17 00:00:00 2001 From: Lumouille <144063653+Lumabots@users.noreply.github.com> Date: Mon, 8 Dec 2025 14:27:29 +0200 Subject: [PATCH 1/5] Expand docstring for Member.voice property The docstring for the Member.voice property now includes a detailed Returns section, clarifying the return type and behavior when the member is not in a voice channel. --- discord/member.py | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/discord/member.py b/discord/member.py index 72cbb912d9..4fe4f0c3e7 100644 --- a/discord/member.py +++ b/discord/member.py @@ -716,7 +716,13 @@ def guild_permissions(self) -> Permissions: @property def voice(self) -> VoiceState | None: - """Returns the member's current voice state.""" + """Returns the member's current voice state. + + Returns + ------- + Optional[:class:`VoiceState`] + The member's voice state or ``None`` if the member is not in a voice channel. + """ return self.guild._voice_state_for(self._user.id) @property From ba30b3eaa9b3004381458f6fe95bb7d53dd105b5 Mon Sep 17 00:00:00 2001 From: Lumouille <144063653+Lumabots@users.noreply.github.com> Date: Mon, 8 Dec 2025 14:38:36 +0200 Subject: [PATCH 2/5] fix: simplify docstring for Member.voice property --- discord/member.py | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/discord/member.py b/discord/member.py index 4fe4f0c3e7..050054bde0 100644 --- a/discord/member.py +++ b/discord/member.py @@ -716,13 +716,7 @@ def guild_permissions(self) -> Permissions: @property def voice(self) -> VoiceState | None: - """Returns the member's current voice state. - - Returns - ------- - Optional[:class:`VoiceState`] - The member's voice state or ``None`` if the member is not in a voice channel. - """ + """Optional[:class:`VoiceState`]: Return the member's current voice state.""" return self.guild._voice_state_for(self._user.id) @property From 4a10b457815c4678af4e00fe70d894a1377fb660 Mon Sep 17 00:00:00 2001 From: Lala Sabathil Date: Mon, 8 Dec 2025 14:07:02 +0100 Subject: [PATCH 3/5] Update discord/member.py Co-authored-by: Paillat Signed-off-by: Lala Sabathil --- discord/member.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/discord/member.py b/discord/member.py index 050054bde0..917992cbad 100644 --- a/discord/member.py +++ b/discord/member.py @@ -716,7 +716,12 @@ def guild_permissions(self) -> Permissions: @property def voice(self) -> VoiceState | None: - """Optional[:class:`VoiceState`]: Return the member's current voice state.""" + """ + Returns + ------- + Optional[:class:`VoiceState`]: + The member's current voice state. + """ return self.guild._voice_state_for(self._user.id) @property From 9e4318a15547be3a787fefdeb166003211e4ec85 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Mon, 8 Dec 2025 13:08:38 +0000 Subject: [PATCH 4/5] style(pre-commit): auto fixes from pre-commit.com hooks --- discord/member.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/discord/member.py b/discord/member.py index 917992cbad..29fd612095 100644 --- a/discord/member.py +++ b/discord/member.py @@ -719,8 +719,8 @@ def voice(self) -> VoiceState | None: """ Returns ------- - Optional[:class:`VoiceState`]: - The member's current voice state. + Optional[:class:`VoiceState`]: + The member's current voice state. """ return self.guild._voice_state_for(self._user.id) From fb5261ca88a1a6ef3dbbb0e2590b148b6a74cca0 Mon Sep 17 00:00:00 2001 From: Lumouille <144063653+Lumabots@users.noreply.github.com> Date: Tue, 9 Dec 2025 10:00:36 +0200 Subject: [PATCH 5/5] revert paillat change --- discord/member.py | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/discord/member.py b/discord/member.py index 29fd612095..050054bde0 100644 --- a/discord/member.py +++ b/discord/member.py @@ -716,12 +716,7 @@ def guild_permissions(self) -> Permissions: @property def voice(self) -> VoiceState | None: - """ - Returns - ------- - Optional[:class:`VoiceState`]: - The member's current voice state. - """ + """Optional[:class:`VoiceState`]: Return the member's current voice state.""" return self.guild._voice_state_for(self._user.id) @property