From a67c634e07817a1f5d523f7dff73dd9b173f2f4b Mon Sep 17 00:00:00 2001
From: shiftinv <8530778+shiftinv@users.noreply.github.com>
Date: Fri, 23 Jun 2023 00:00:52 +0200
Subject: [PATCH] docs: clarify `Member.current_timeout` expiry (#1063)

Tiny documentation change to clarify that `Member.current_timeout` also
returns `None` when the current timeout value is in the past, allowing
users to safely rely on this behavior.
---
 disnake/member.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/disnake/member.py b/disnake/member.py
index f3ff9008f7..25886079eb 100644
--- a/disnake/member.py
+++ b/disnake/member.py
@@ -695,7 +695,9 @@ def voice(self) -> Optional[VoiceState]:
 
     @property
     def current_timeout(self) -> Optional[datetime.datetime]:
-        """Optional[:class:`datetime.datetime`]: Returns the datetime when the timeout expires, if any.
+        """Optional[:class:`datetime.datetime`]: Returns the datetime when the timeout expires.
+
+        If the member is not timed out or the timeout has already expired, returns ``None``.
 
         .. versionadded:: 2.3
         """