Improved helper messages

Author: rambabu-yalla

src/azure-cli/azure/cli/command_modules/sql/_help.py

@@ -1834,7 +1834,7 @@
 examples:
   - name: Update a server. (autogenerated)
     text: az sql server update --admin-password myadminpassword --name MyAzureSQLServer --resource-group MyResourceGroup
-  - name: Enable soft delete protection with 7-day retention.
+  - name: Enable soft delete protection with default (7-day) retention.
     text: az sql server update --name MyAzureSQLServer --resource-group MyResourceGroup --enable-soft-delete
   - name: Modify soft delete retention period.
     text: az sql server update --name MyAzureSQLServer --resource-group MyResourceGroup --enable-soft-delete --soft-delete-retention-days 5

src/azure-cli/azure/cli/command_modules/sql/_params.py

@@ -1920,7 +1920,9 @@ def _configure_security_policy_storage_params(arg_ctx):
 
         c.argument('soft_delete_retention_days',
                    options_list=['--soft-delete-retention-days', '--sdrd'],
-                   help='Specify the number of days to retain soft deleted server',
+                   help='Specify the number of days to retain soft deleted server. During this period, '
+                   'the server can be restored to an active state with az sql server restore. '
+                   'After this period has elapsed, the server is hard deleted and can not be restored.',
                    validator=validate_soft_delete_parameters)
 
     with self.argument_context('sql server create') as c:
@@ -2319,7 +2321,7 @@ def _configure_security_policy_storage_params(arg_ctx):
     with self.argument_context('sql server deleted-server list') as c:
         c.argument('location', arg_type=get_location_type(self.cli_ctx),
                    required=True,
-                   help='Location to list deleted servers from.')
+                   help='List deleted servers in this location.')
 
     ###############################################
     #                sql managed instance         #