From cf96ba73f1d1223836f8886227a87e53b4ec4eed Mon Sep 17 00:00:00 2001
From: Gerorge Liao <george.liao@canonical.com>
Date: Wed, 18 Sep 2024 15:49:10 +0200
Subject: [PATCH] [cmd] improved the clone help text based the documentation
 review.

---
 src/client/cli/cmd/clone.cpp | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/client/cli/cmd/clone.cpp b/src/client/cli/cmd/clone.cpp
index 3ba522bb9b..eaddea0ed5 100644
--- a/src/client/cli/cmd/clone.cpp
+++ b/src/client/cli/cmd/clone.cpp
@@ -62,18 +62,18 @@ QString cmd::Clone::short_help() const
 
 QString cmd::Clone::description() const
 {
-    return QStringLiteral("Create a complete independent copy of an existing instance");
+    return QStringLiteral(
+        "Create an independent copy of an existing instance. The instance must be stopped before you proceed.");
 }
 
 mp::ParseCode cmd::Clone::parse_args(ArgParser* parser)
 {
-    parser->addPositionalArgument("source_name", "The name of the source instance", "<source_name>");
+    parser->addPositionalArgument("source_name", "The name of the source instance to be cloned", "<source_name>");
 
     const QCommandLineOption destination_name_option{
         {"n", "name"},
-        "An optional name for the destination instance, it obeys the same validity rules as instance names (see "
-        "\"help launch\"). Default: \"<source_name>-cloneN\", where N is the Nth cloned instance of the original "
-        "instance.",
+        "Specify a custom name for the cloned instance. The name must follow the same validity rules as instance names "
+        "(see \"help launch\"). Default: \"<source_name>-cloneN\", where N is the Nth cloned instance.",
         "destination-name"};
 
     parser->addOption(destination_name_option);