diff --git a/ocf/NovaCompute b/ocf/NovaCompute
index fde9c26..3946c9b 100644
--- a/ocf/NovaCompute
+++ b/ocf/NovaCompute
@@ -120,7 +120,12 @@ This option should be used with caution.
 
 <parameter name="no_shared_storage" unique="0" required="0">
 <longdesc lang="en">
-Disable shared storage recovery for instances. Use at your own risk!
+Indicate that nova storage for instances is not shared across compute
+nodes. This must match the reality of how nova storage is configured!
+Otherwise VMs could end up in error state upon evacuation. When
+storage is non-shared, instances on dead hypervisors will be rebuilt
+from their original image or volume, so anything on ephemeral storage
+will be lost.
 </longdesc>
 <shortdesc lang="en">Disable shared storage recovery for instances</shortdesc>
 <content type="boolean" default="0" />
diff --git a/ocf/NovaEvacuate b/ocf/NovaEvacuate
index c5195c6..0fcd041 100644
--- a/ocf/NovaEvacuate
+++ b/ocf/NovaEvacuate
@@ -120,7 +120,12 @@ This option should be used with caution.
 
 <parameter name="no_shared_storage" unique="0" required="0">
 <longdesc lang="en">
-Disable shared storage recovery for instances. Use at your own risk!
+Indicate that nova storage for instances is not shared across compute
+nodes. This must match the reality of how nova storage is configured!
+Otherwise VMs could end up in error state upon evacuation. When
+storage is non-shared, instances on dead hypervisors will be rebuilt
+from their original image or volume, so anything on ephemeral storage
+will be lost.
 </longdesc>
 <shortdesc lang="en">Disable shared storage recovery for instances</shortdesc>
 <content type="boolean" default="0" />