From 466fc33bae8cfc205187fa1d88492a2b2fa5de25 Mon Sep 17 00:00:00 2001
From: Dean Chen <862469039@qq.com>
Date: Mon, 17 Aug 2026 18:55:42 +0500
Subject: [PATCH] docs: say swarm drain does not wait for replacement tasks

Signed-off-by: Dean Chen <862469039@qq.com>
---
 content/manuals/engine/swarm/swarm-tutorial/drain-node.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/content/manuals/engine/swarm/swarm-tutorial/drain-node.md b/content/manuals/engine/swarm/swarm-tutorial/drain-node.md
index 1e412606a1ea..761eeda87fb8 100644
--- a/content/manuals/engine/swarm/swarm-tutorial/drain-node.md
+++ b/content/manuals/engine/swarm/swarm-tutorial/drain-node.md
@@ -21,6 +21,11 @@ node and launches replica tasks on a node with `Active` availability.
 > such as those created with `docker run`, `docker compose up`, or the Docker Engine
 > API. A node's status, including `Drain`, only affects the node's ability to schedule
 > swarm service workloads.
+>
+> Drain also does not wait for replacement tasks to be running on another node
+> before it stops the tasks on the drained node. The service can drop below its
+> replica count while the new tasks start. If you drain the last worker that
+> still has replicas, those tasks stop together.
 
 1.  If you haven't already, open a terminal and ssh into the machine where you
     run your manager node. For example, the tutorial uses a machine named