Improved docstrings for both functions

Author: LoCrealloc

PyDrocsid/converter.py

@@ -69,6 +69,13 @@ class DurationConverter(Converter[int | None]):
     """
 
     async def convert(self, ctx: Context[Bot], argument: str) -> int | None:
+        """
+        Extracts information about years, months, weeks, days, hours and minutes from a string
+        and returns the total amount of time in minutes
+        :param ctx: the context the converter was called in
+        :param argument: the string with the different time units or a variation of 'inf' for an infinite time span
+        :returns: the total amount of time in minutes as an int or None if the time span is infinite
+        """
         if argument.lower() in ("inf", "perm", "permanent", "-1", "∞"):
             return None
         if (match := re.match(r"^(\d+y)?(\d+m)?(\d+w)?(\d+d)?(\d+H)?(\d+M)?$", argument)) is None:

PyDrocsid/util.py

@@ -238,7 +238,7 @@ def check_message_send_permissions(
 
 def time_to_units(minutes: int | float) -> str:
     """
-    Util function to split minutes back into different time units
+    Util function to split a time span given in minutes into the different units years, months, days, hours and minutes
     """
     _keys = ("years", "months", "days", "hours", "minutes")