fix: edit messages for new source-tracking commands

* fix: edit messages for new source-tracking commands

* Update org.enable.tracking.md

* Update org.disable.tracking.md

Author: jshackell-sfdc

messages/org.disable.tracking.md

@@ -1,24 +1,24 @@
 # summary
 
-Disable source tracking in local auth file.
+Prevent Salesforce CLI from tracking changes in your source files between your project and an org.
 
 # description
 
-This has no effect on the org. It stores the setting in the CLI's configuration file for this org so that no source tracking operations are executed when working with this org.
+Disabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that no source tracking operations are executed when working with the org.
 
 # examples
 
-Disable tracking on an org using an alias
+- Disable source tracking for an org with alias "myscratch":
 
-- <%= config.bin %> <%= command.id %> -o someAlias
+  <%= config.bin %> <%= command.id %> --target-org myscratch
 
-Disable tracking on an org using a username
+- Disable source tracking for an org using a username:
 
-- <%= config.bin %> <%= command.id %> -o [email protected]
+  <%= config.bin %> <%= command.id %> --target-org [email protected]
 
-Disable tracking on your default org
+- Disable source tracking for your default org:
 
-- <%= config.bin %> <%= command.id %>
+  <%= config.bin %> <%= command.id %>
 
 # success
 

messages/org.enable.tracking.md

@@ -1,39 +1,39 @@
 # summary
 
-Enable source tracking in local auth file.
+Allow Salesforce CLI to track changes in your source files between your project and an org.
 
 # description
 
-This has no effect on the org. It stores the setting in the CLI's configuration file for this org so that source tracking operations are executed when working with this org.
+Enabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that source tracking operations are executed when working with the org.
 
-This command will throw an error if the org does not support tracking.
+This command throws an error if the org doesn't support tracking. Examples of orgs that don't support source tracking include Developer Edition orgs, production orgs, Partial Copy sandboxes, and Full sandboxes.
 
 # examples
 
-Enable tracking on an org using an alias
+- Enable source tracking for an org with alias "myscratch":
 
-- <%= config.bin %> <%= command.id %> -o someAlias
+  <%= config.bin %> <%= command.id %> --target-org myscratch
 
-Enable tracking on an org using a username
+- Enable source tracking for an org using a username:
 
-- <%= config.bin %> <%= command.id %> -o [email protected]
+  <%= config.bin %> <%= command.id %> --target-org [email protected]
 
-Enable tracking on your default org
+- Enable source tracking for your default org:
 
-- <%= config.bin %> <%= command.id %>
+  <%= config.bin %> <%= command.id %>
 
 # success
 
 Enabled source tracking for %s.
 
 # error.TrackingNotAvailable
 
-This org cannot enable source tracking because the SourceMember object is not available, or you do not have access to it.
+You can't enable source tracking on this org because the SourceMember Tooling API object isn't available, or you don't have access to it.
 
 # error.TrackingNotAvailable.actions
 
-- If the org is a sandbox, make sure that your production org has Source Tracking enabled in sandboxes. See https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_setup_enable_source_tracking_sandboxes.htm.
+- If the org is a Developer or Developer Pro sandbox, make sure that the associated production org has enabled source tracking in sandboxes. See https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_setup_enable_source_tracking_sandboxes.htm.
 
-- Make sure that your user can access the SourceMembers table via the tooling API.
+- Make sure that your user can access the SourceMember Tooling API object.
 
-- If the Org is a production org, source tracking cannot be enabled.
+- You can't enable source tracking on Developer Edition orgs, production orgs, Partial Copy sandboxes, or Full sandboxes.

package.json

@@ -14,7 +14,7 @@
   },
   "devDependencies": {
     "@oclif/plugin-command-snapshot": "^5.0.2",
-    "@salesforce/cli-plugins-testkit": "^5.0.4",
+    "@salesforce/cli-plugins-testkit": "^5.0.3",
     "@salesforce/dev-scripts": "^7.1.1",
     "@salesforce/plugin-command-reference": "^3.0.46",
     "@salesforce/ts-sinon": "1.4.19",
@@ -72,10 +72,10 @@
             "description": "Delete scratch orgs, sandboxes, org shapes, and org snapshots."
           },
           "enable": {
-            "description": "Enable tracking on an org."
+            "description": "Enable source tracking in an org."
           },
           "disable": {
-            "description": "Disable tracking on an org"
+            "description": "Disable source tracking in an org."
           }
         },
         "external": true