Set docstrings, prepare for release

Author: jacopofar

CHANGELOG.md

@@ -1,9 +1,9 @@
 # Changelog
 
-## 1.2.0 - 2024-07-23
+## 1.2.0 - 2024-07-25
 
-* The `reschedule()` method have an optional parameter to decrease the ttl if set to True (False by default).
-* The `add()` and `addMany()` methods set the can_start_at by default to the current time of the database clock for consistency.
+* The `reschedule()` method has an optional parameter to decrease the TTL if set to True (False by default).
+* The `add()` and `add_many()` methods set the `can_start_at` by default to the current time of the database clock, not Python, for consistency.
 
 ## 1.1.0 - 2024-07-01
 

postgrestq/task_queue.py

@@ -588,9 +588,13 @@ def reschedule(
 
         Workers can use this method to "drop" a work unit in case of
         eviction (because of an external issue like terminating a machine
-        by aws and not because of a failure).
+        by AWS and not because of a failure).
+        Rescheduled work units are immediately available for processing again,
+        and unless decrease_ttl is set to True, the TTL is not modified.
 
-        This function can optionally modify the TTL.
+        This function can optionally modify the TTL, setting decrease_ttl to
+        True. This allows to handle a failure quickly without waiting the
+        lease_timeout.
 
         Parameters
         ----------