debouncing v2

Signed-off-by: pyranota <pyra@duck.com>

Author: pyranota

docs/script_editor/job_debouncing.mdx

@@ -4,18 +4,32 @@ canonical_url: /docs/core_concepts/job_debouncing
 
 # Job debouncing
 
-Job debouncing limits job duplicates. When a script is queued with the same debouncing key within the specified time window, only the most recent one will run. This helps prevent duplicate executions and reduces unnecessary API calls.
+When job debouncing is enabled, started jobs are scheduled for a specified future time. If another job with the same debounce key is queued within this duration, it will "debounce" the previous job by canceling it.
 
 Job debouncing is a [Cloud plans and Pro Enterprise Self-Hosted](/pricing) only feature.
 
-Job debouncing can be set from the Settings menu. When jobs share the same debouncing key within the time window, earlier jobs are automatically cancelled as "debounced" and only the latest job runs.
+Job debouncing can be set from the Settings menu. The Job debouncing feature operates globally and involves several configuration fields:
 
-The Job debouncing feature operates globally and involves two key parameters:
+## Configuration fields
 
-## Debounce delay in seconds
+### Debounce delay in seconds
 
-Set in seconds, the time window defines the period within which jobs with the same key are debounced.
+The time window in seconds for debouncing. If not set, the job will not debounce existing jobs and will not be cancelled by any other job.
 
-## Custom debouncing key  
+### Custom debounce key
 
-This parameter is optional. Debouncing keys are global, you can have them be workspace specific using the variable `$workspace`. You can also use an argument's value using `$args[name_of_arg]`.
+Optional field to create debounce keys that are not bound to path and arguments. If not set, the default debounce key is used, which is composed of workspace ID, runnable path, and argument values passed to it.
+
+Debouncing keys are global, you can have them be workspace specific using the variable `$workspace`. You can also use an argument's value using `$args[name_of_arg]`.
+
+### Max Total Debouncing Time
+
+How long (in seconds) a job can be debounced by the same key. If exceeded, new jobs with the same key will not debounce existing jobs and let them execute, while still scheduling themselves for future execution.
+
+### Max Total Debounces Amount
+
+Same as previous one, but counts debounces instead of time.
+
+### Debounce Args To Accumulate
+
+This field allows you to consolidate arguments across debounced jobs. If one of your main function arguments takes an array of any type, you can specify this argument in this parameter. This will exclude it from the default debounce key and when the job executes, it will concatenate all values of the specified argument from previous jobs related to this debouncing period.