Merge pull request #966 from salesforcecli/btrn/fix-help-texts-plugin

@W-18683180 Fix help texts messages and remove beta flags

Author: btrn11

command-snapshot.json

@@ -4,7 +4,7 @@ Abort a package push upgrade that has been scheduled. Only push upgrade requests
 
 # description
 
-Specify the request ID for which you want abort the request. If applicable, the command displays errors related to the request. Only package push requests in Created or Pending statuses can be aborted.
+Specify the request ID for which you want abort the request. If applicable, the command displays errors related to the request.
 
 To show all requests in the org, run "<%= config.bin %> package pushupgrade list --package 033...".
 

messages/package_pushupgrade_abort.md

@@ -26,10 +26,6 @@ Status used to filter the list output Valid values are: Created, Canceled, Pendi
 
 Display only push upgrade requests for package migrations.
 
-# flags.verbose.summary
-
-Displays additional information such as number of orgs scheduled for push upgrade, orgs successfully upgraded, etc.
-
 # examples
 
 - List all package push upgrade requests in the specified Dev Hub org:
@@ -40,13 +36,13 @@ Displays additional information such as number of orgs scheduled for push upgrad
 
   <%= config.bin %> <%= command.id %> --package 033xyz --scheduled-last-days 30 --target-dev-hub myHub
 
-- List all package push upgrade with a status Success:
+- List all package push upgrade with a status Succeeded:
 
-  <%= config.bin %> <%= command.id %> --package 033xyz –-Status=Success
+  <%= config.bin %> <%= command.id %> --package 033xyz –-status Succeeded
 
-- List all package push upgrade with a status Error:
+- List all package push upgrade with a status Failed:
 
-  <%= config.bin %> <%= command.id %> --package 033xyz –-Status=Error
+  <%= config.bin %> <%= command.id %> --package 033xyz –-status Failed
 
 # id
 

messages/package_pushupgrade_list.md

@@ -10,7 +10,7 @@ To show all requests in the org, run "<%= config.bin %> package pushupgrade list
 
 # examples
 
-- Retrieve details about the package push updgrade with the specified ID; uses your default Dev Hub org:
+- Retrieve details about the package push upgrade with the specified ID; uses your default Dev Hub org:
 
   <%= config.bin %> <%= command.id %> --push-request-id 0DV...
 

messages/package_pushupgrade_report.md

@@ -9,7 +9,7 @@ To initiate a push upgrade for an unlocked or second-generation managed package,
 For second-generation managed packages, the push upgrade feature is available only for packages that have passed AppExchange security review. To enable push upgrades for your managed package, log a support case in the Salesforce Partner Community.
 For unlocked packages, push upgrades are enabled by default.
 
-Use the –migrate-to-2GP flag to indicate you’re installing a converted second-generation managed package into an org that has the first-generation managed package version of that package installed.
+Use the -–migrate-to-2GP flag to indicate you’re installing a converted second-generation managed package into an org that has the first-generation managed package version of that package installed.
 
 # flags.target-dev-hub.summary
 
@@ -27,10 +27,22 @@ ID (starts with 04t) of the package version that the package is being upgraded t
 
 Date and time (UTC) when the push upgrade is processed. Set to the earliest time that you want Salesforce to attempt to start the upgrade.
 
+# flags.start-time.description
+
+Scheduled push upgrades begin as soon as resources are available on the Salesforce instance, which is either at or after the start time you specify. In certain scenarios, the push upgrade starts a few hours after the scheduled start time.
+
+As a best practice, schedule push upgrades at off-peak hours like 1:00 AM Saturday.  
+If you don't specify this flag, the push upgrade is scheduled to run as soon as resources are available on the Salesforce instance.
+
 # flags.org-file.summary
 
 Filename of the CSV file that contains the list of orgs that need the package upgrade.
 
+# flags.org-file.description
+
+The file must contain one org per line. The org ID must be the only value in each row. 
+All listed orgs must have a package version installed in their org that is lower than the package version you specified for the --package-version flag.
+
 # flags.org-list.summary
 
 Comma-separated list of subscriber org IDs that need the package upgrade.
@@ -94,3 +106,4 @@ Package Version Id
 # output
 
 Push upgrade has been scheduled. To check the status of this push upgrade, use push upgrade request ID [%s] with either "package push-upgrade list" or "package push-upgrade report".
+Orgs scheduled for push upgrade: {%s}

messages/package_pushupgrade_schedule.md

@@ -15,8 +15,6 @@ export class PackagePushUpgradeAbortCommand extends SfCommand<boolean> {
   public static readonly summary = messages.getMessage('summary');
   public static readonly description = messages.getMessage('description');
   public static readonly examples = messages.getMessages('examples');
-  public static readonly hidden = true;
-  public static state = 'beta';
   public static readonly flags = {
     'target-dev-hub': Flags.requiredHub(),
     'api-version': Flags.orgApiVersion(),

src/commands/package/push-upgrade/abort.ts

@@ -20,8 +20,6 @@ export class PackagePushRequestListCommand extends SfCommand<PackagePushRequestL
   public static readonly summary = messages.getMessage('summary');
   public static readonly description = messages.getMessage('description');
   public static readonly examples = messages.getMessages('examples');
-  public static readonly hidden = true;
-  public static state = 'beta';
   public static readonly aliases = ['force:package:push-upgrade:list'];
   public static readonly flags = {
     'target-dev-hub': requiredHubFlag,

src/commands/package/push-upgrade/list.ts

@@ -29,8 +29,6 @@ export class PackagePushUpgradeReportCommand extends SfCommand<ReportCommandResu
   public static readonly examples = messages.getMessages('examples');
   public static readonly deprecateAliases = true;
   public static readonly aliases = ['force:package:push-upgrade:report'];
-  public static readonly hidden = true;
-  public static readonly state = 'beta';
   public static readonly flags = {
     loglevel,
     'target-dev-hub': requiredHubFlag,

src/commands/package/push-upgrade/report.ts

@@ -16,8 +16,6 @@ export class PackagePushScheduleCommand extends SfCommand<PackagePushScheduleRes
   public static readonly summary = messages.getMessage('summary');
   public static readonly description = messages.getMessage('description');
   public static readonly examples = messages.getMessages('examples');
-  public static readonly hidden = true;
-  public static state = 'beta';
   public static readonly flags = {
     'target-dev-hub': Flags.requiredHub({
       char: 'v',
@@ -36,6 +34,7 @@ export class PackagePushScheduleCommand extends SfCommand<PackagePushScheduleRes
     'start-time': Flags.string({
       char: 't',
       summary: messages.getMessage('flags.start-time.summary'),
+      description: messages.getMessage('flags.start-time.description'),
     }),
     'org-list': Flags.string({
       char: 'l',
@@ -45,6 +44,7 @@ export class PackagePushScheduleCommand extends SfCommand<PackagePushScheduleRes
     'org-file': Flags.file({
       char: 'f',
       summary: messages.getMessage('flags.org-file.summary'),
+      description: messages.getMessage('flags.org-file.description'),
       exists: true,
       exclusive: ['org-list'],
     }),
@@ -83,7 +83,7 @@ export class PackagePushScheduleCommand extends SfCommand<PackagePushScheduleRes
     );
 
     // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-    this.log(messages.getMessage('output', [result?.PushRequestId]));
+    this.log(messages.getMessage('output', [result?.PushRequestId, orgList.join(', ')]));
 
     // eslint-disable-next-line @typescript-eslint/no-unsafe-return
     return result;