diff --git a/messages/bundle_uninstall.md b/messages/bundle_uninstall.md
index 4342005c..e28c7628 100644
--- a/messages/bundle_uninstall.md
+++ b/messages/bundle_uninstall.md
@@ -4,17 +4,17 @@ Uninstall a package bundle version from a target org.
 
 # description
 
-Provide the package bundle version ID or alias and the target org to start an uninstall request. Optionally wait for the uninstall to complete.
+To start an uninstall request, provide the package bundle version ID or alias and the target org. Optionally enter the number of minutes to wait for the uninstall to complete. If the time to uninstall exceeds the number of minutes, the request times out.
 
 # examples
 
-- Uninstall a bundle version by ID from a specified org:
+- Uninstall a bundle version by ID from the example org myorg@example.com:
 
-  <%= config.bin %> <%= command.id %> --bundle 1Q8... --target-org me@example.com
+  <%= config.bin %> <%= command.id %> --bundle 1Q8... --target-org myorg@example.com
 
-- Uninstall a bundle version by alias from your default org and wait up to 10 minutes for completion:
+- Uninstall a bundle version by alias from your default org and wait up to 10 minutes to complete:
 
-  <%= config.bin %> <%= command.id %> --bundle MyBundle@1.2 -w 10
+  <%= config.bin %> <%= command.id %> --bundle MyBundle@1.2 --wait 10
 
 # flags.bundle.summary
 
@@ -26,11 +26,11 @@ Number of minutes to wait for the uninstall request to complete.
 
 # flags.verbose.summary
 
-Show additional progress while waiting for uninstall to finish.
+Show additional progress information while waiting for the uninstall to finish.
 
 # bundleUninstallWaitingStatus
 
-Waiting %s more minutes for bundle uninstall. Current status: %s
+Waiting %s more minutes for the bundle to uninstall. Current status: %s
 
 # bundleUninstallError