diff --git a/docs/content.zh/docs/deployment/tasks-scheduling/balanced_tasks_scheduling.md b/docs/content.zh/docs/deployment/tasks-scheduling/balanced_tasks_scheduling.md
index 7006cc56e0c88..b8c5ce8ec0918 100644
--- a/docs/content.zh/docs/deployment/tasks-scheduling/balanced_tasks_scheduling.md
+++ b/docs/content.zh/docs/deployment/tasks-scheduling/balanced_tasks_scheduling.md
@@ -116,6 +116,16 @@ You can enable balanced tasks scheduling through the following configuration ite
- `taskmanager.load-balance.mode`: `tasks`
+Note During failover scenarios,
+when resources are released and resource requests are processed,
+the delayed updates in the resource view may lead to allocation results that are not optimally balanced.
+In such cases, you can improve the situation by appropriately increasing the value of
+[`slot.request.max-interval`]({{< ref "docs/deployment/config" >}}#slot-request-max-interval).
+It must be emphasized that if suboptimal task balancing still occurs after the value of
+option has been sufficiently increased, you may report it in
+FLINK-38715,
+which should include descriptions of scheduling-related configurations and the observed phenomena.
+
## More details
See the FLIP-370 for more details.
diff --git a/docs/content/docs/deployment/tasks-scheduling/balanced_tasks_scheduling.md b/docs/content/docs/deployment/tasks-scheduling/balanced_tasks_scheduling.md
index 7006cc56e0c88..b8c5ce8ec0918 100644
--- a/docs/content/docs/deployment/tasks-scheduling/balanced_tasks_scheduling.md
+++ b/docs/content/docs/deployment/tasks-scheduling/balanced_tasks_scheduling.md
@@ -116,6 +116,16 @@ You can enable balanced tasks scheduling through the following configuration ite
- `taskmanager.load-balance.mode`: `tasks`
+Note During failover scenarios,
+when resources are released and resource requests are processed,
+the delayed updates in the resource view may lead to allocation results that are not optimally balanced.
+In such cases, you can improve the situation by appropriately increasing the value of
+[`slot.request.max-interval`]({{< ref "docs/deployment/config" >}}#slot-request-max-interval).
+It must be emphasized that if suboptimal task balancing still occurs after the value of
+option has been sufficiently increased, you may report it in
+FLINK-38715,
+which should include descriptions of scheduling-related configurations and the observed phenomena.
+
## More details
See the FLIP-370 for more details.