Document retry duration

Author: r4victor

docs/docs/concepts/dev-environments.md

@@ -458,6 +458,10 @@ retry:
 
 </div>
 
+!!! info "Retry duration"
+    The duration period is calculated as a run age for `no-capacity` event
+    and as a time passed since the last `interruption` and `error` for `interruption` and `error` events..
+
 ### Inactivity duration
 
 Set [`inactivity_duration`](../reference/dstack.yml/dev-environment.md#inactivity_duration)

docs/docs/concepts/services.md

@@ -821,6 +821,9 @@ retry:
 If one replica of a multi-replica service fails with retry enabled,
 `dstack` will resubmit only the failed replica while keeping active replicas running.
 
+!!! info "Retry duration"
+    The duration period is calculated as a run age for `no-capacity` event and as a time passed since the last `interruption` and `error` for `interruption` and `error` events..
+
 ### Spot policy
 
 By default, `dstack` uses on-demand instances. However, you can change that

docs/docs/concepts/tasks.md

@@ -718,6 +718,9 @@ retry:
 If one job of a multi-node task fails with retry enabled,
 `dstack` will stop all the jobs and resubmit the run.
 
+!!! info "Retry duration"
+    The duration period is calculated as a run age for `no-capacity` event and as a time passed since the last `interruption` and `error` for `interruption` and `error` events..
+
 ### Priority
 
 Be default, submitted runs are scheduled in the order they were submitted.

src/dstack/_internal/core/models/profiles.py

@@ -146,7 +146,13 @@ class ProfileRetry(generate_dual_core_model(ProfileRetryConfig)):
     ] = None
     duration: Annotated[
         Optional[int],
-        Field(description="The maximum period of retrying the run, e.g., `4h` or `1d`"),
+        Field(
+            description=(
+                "The maximum period of retrying the run, e.g., `4h` or `1d`."
+                " The period is calculated as a run age for `no-capacity` event"
+                " and as a time passed since the last `interruption` and `error` for `interruption` and `error` events."
+            )
+        ),
     ] = None
 
     _validate_duration = validator("duration", pre=True, allow_reuse=True)(parse_duration)