diff --git a/doc/common/section_cli_nova_evacuate.xml b/doc/common/section_cli_nova_evacuate.xml
index 3dfb9afbdb..7556dda861 100644
--- a/doc/common/section_cli_nova_evacuate.xml
+++ b/doc/common/section_cli_nova_evacuate.xml
@@ -6,8 +6,9 @@
xml:id="nova_cli_evacuate">
Evacuate instances
If a cloud compute node fails due to a hardware malfunction or another reason, you can
- evacuate instances to make them available again. You can choose evacuation parameters for
- your use case.
+ evacuate instances to make them available again. You can optionally include the target host
+ on the evacuate command. If you omit the host, the scheduler determines
+ the target host.
To preserve user data on server disk, you must configure shared storage on the target
host. Also, you must validate that the current VM host is down; otherwise, the evacuation
fails with an error.