Addressing CX feedback

Author: sbosio

src/commands/data/pg/upgrade/run.ts

@@ -16,12 +16,12 @@ export default class DataPgUpgradeRun extends BaseCommand {
     }),
   }
 
-  static description = 'upgrade the Postgres version on a Heroku Postgres Advanced database'
+  static description = 'upgrade the Postgres version on a Postgres Advanced database'
 
   static examples = [
     heredoc`
-      # Upgrade a Heroku Postgres Advanced database to version 17
-      <%= config.bin %> <%= command.id %> DATABASE --version 17 --app my-app
+      # Upgrade a Postgres Advanced database to version 17
+      ${color.code('<%= config.bin %> <%= command.id %> DATABASE --version 17 --app my-app')}
     `,
   ]
 
@@ -43,7 +43,7 @@ export default class DataPgUpgradeRun extends BaseCommand {
     if (!utils.pg.isAdvancedDatabase(addon)) {
       ux.error(
         'You can only use this command on Advanced-tier databases.\n'
-          + `Run ${color.code(`heroku pg:upgrade:run ${addon.name} --app ${app}`)} instead.`,
+          + `Use ${color.code(`heroku pg:upgrade:run ${addon.name} --app ${app}`)} instead.`,
       )
     }
 
@@ -65,7 +65,7 @@ export default class DataPgUpgradeRun extends BaseCommand {
         {body: {version}},
       )
       ux.action.stop()
-      ux.stderr(`Upgrade started. Run ${color.code(`heroku data:pg:upgrade:wait ${addon.name} -a ${app}`)} to monitor progress.`)
+      ux.stderr(`Upgrade started. Use ${color.code(`heroku data:pg:upgrade:wait ${addon.name} -a ${app}`)} to monitor progress.`)
     } catch (error: unknown) {
       ux.action.stop(color.red('!'))
       throw error

src/commands/data/pg/upgrade/wait.ts

@@ -11,11 +11,11 @@ export default class DataPgUpgradeWait extends DataPgWait {
   static examples = [
     heredoc(`
       # Wait for upgrade to complete
-      ${color.command('heroku data:pg:upgrade:wait DATABASE --app myapp')}
+      ${color.code('<%= config.bin %> <%= command.id %> DATABASE --app myapp')}
     `),
     heredoc(`
       # Wait with custom polling interval (to avoid rate limiting)
-      ${color.command('heroku data:pg:upgrade:wait DATABASE --app myapp --wait-interval 10')}
+      ${color.code('<%= config.bin %> <%= command.id %> DATABASE --app myapp --wait-interval 10')}
     `),
   ]
 

src/commands/data/pg/wait.ts

@@ -26,7 +26,7 @@ export default class DataPgWait extends BaseCommand {
   static examples = [
     heredoc(`
       # Wait for database to be available
-      ${color.command('heroku data:pg:wait DATABASE --app myapp')}
+      ${color.code('<%= config.bin %> <%= command.id %> DATABASE --app myapp')}
     `),
   ]
 
@@ -60,7 +60,7 @@ export default class DataPgWait extends BaseCommand {
     if (!isAdvancedDatabase(addon)) {
       ux.error(heredoc`
         You can only use this command on Advanced-tier databases.
-        Run ${color.code(`heroku ${this.classicWaitCommand} ${addon.name} -a ${app}`)} instead.`)
+        Use ${color.code(`heroku ${this.classicWaitCommand} ${addon.name} -a ${app}`)} instead.`)
     }
 
     await this.waitFor(addon, waitInterval || 5, noNotify)

test/unit/commands/data/pg/upgrade/run.unit.test.ts

@@ -38,7 +38,7 @@ describe('data:pg:upgrade:run', function () {
     expect(ansis.strip(stderr.output)).to.equal(
       heredoc(`
         Upgrading your ⛁ ${addon.name} database from 16.10 to the latest supported Postgres version... done
-        Upgrade started. Run heroku data:pg:upgrade:wait advanced-horizontal-01234 -a myapp to monitor progress.
+        Upgrade started. Use heroku data:pg:upgrade:wait advanced-horizontal-01234 -a myapp to monitor progress.
       `),
     )
     expect(stdout.output).to.equal('')
@@ -86,7 +86,7 @@ describe('data:pg:upgrade:run', function () {
       resolveApi.done()
       expect(ansis.strip((error as Error).message)).to.equal(
         'You can only use this command on Advanced-tier databases.\n'
-          + `Run heroku pg:upgrade:run ${addon.name} --app myapp instead.`,
+          + `Use heroku pg:upgrade:run ${addon.name} --app myapp instead.`,
       )
     }
   })

test/unit/commands/data/pg/upgrade/wait.unit.test.ts

@@ -102,7 +102,7 @@ describe('data:pg:upgrade:wait', function () {
         const err = error as Error
         expect(ansis.strip(err.message)).to.equal(heredoc`
           You can only use this command on Advanced-tier databases.
-          Run heroku pg:upgrade:wait standard-database -a myapp instead.`)
+          Use heroku pg:upgrade:wait standard-database -a myapp instead.`)
       }
     })
 

test/unit/commands/data/pg/wait.unit.test.ts

@@ -150,7 +150,7 @@ describe('data:pg:wait', function () {
         const err = error as Error
         expect(ansis.strip(err.message)).to.equal(heredoc`
           You can only use this command on Advanced-tier databases.
-          Run heroku pg:wait standard-database -a myapp instead.`)
+          Use heroku pg:wait standard-database -a myapp instead.`)
       }
     })