diff --git a/messages/bundle_create.md b/messages/bundle_create.md index 5bdb4180..68d998bc 100644 --- a/messages/bundle_create.md +++ b/messages/bundle_create.md @@ -1,17 +1,16 @@ # summary -Create a package bundle in the Dev Hub org. +Create a package bundle in the Dev Hub org. # description -A package bundle is an artifact that contains one or more 2GP managed packages. -A bundle can be installed or upgraded as a single artifact. +A package bundle is an artifact composed of one or more 2GP managed packages. With a package bundle, you can develop, install, upgrade, and manage multiple packages as a single unit. # examples -Create a package bundle in the Dev Hub org; uses the Dev Hub org with the username devhub@example.com: +- Create a package bundle in the Dev Hub org; uses the Dev Hub org with the username devhub@example.com: -sf package bundle create --name "Your bundle name" --description "Your bundle description" --target-dev-hub devhub@example.com + <%= config.bin %> <%= command.id %> --name "Your bundle name" --description "Your bundle description" --target-dev-hub devhub@example.com # flags.name.summary @@ -23,11 +22,11 @@ Description of the package bundle. # flags.wait.summary -Number of minutes to wait for the bundle creation to complete. +Number of minutes to wait for the package bundle to be created. # flags.verbose.summary -Display extended bundle creation detail. +Display extended details about the package bundle creation. # requestInProgress diff --git a/messages/bundle_install.md b/messages/bundle_install.md index 71321c49..267262ae 100644 --- a/messages/bundle_install.md +++ b/messages/bundle_install.md @@ -1,28 +1,24 @@ # summary -Install a package bundle version in the target org. +Install a specific version of a package bundle in the target org. # description -Install a specific version of a package bundle in the target org. During developer preview, bundles can be installed only in scratch orgs. +During developer preview, package bundles can be installed only in scratch orgs. To install a package bundle in a scratch org, add the PackageBundles feature to the scratch org definition file. -# examples +# examples -- Install a package bundle version in a scratch org: +- Install a package bundle version in a scratch org and wait 10 minutes for the installation to complete: - <%= config.bin %> <%= command.id %> --bundle MyPkgBundle1@0.1 --target-org my-scratch-org --dev-hub-org 00Dxx0000000000 --wait 10 - -- Install using a bundle version ID: - - <%= config.bin %> <%= command.id %> --bundle 1Q8Wt0000000q1pKAA --target-org my-scratch-org --dev-hub-org 00Dxx0000000000 --wait 10 + <%= config.bin %> <%= command.id %> --bundle MyPkgBundle1@0.1 --target-org my-scratch-org --dev-hub-org devhub@example.com --wait 10 # flags.bundle.summary -Package bundle version to install (format: BundleName@Version or bundle version ID). +Package bundle version to install. The valid format is BundleName@VersionNumber, such as "MyPkgBundle@0.1". # flags.target-org.summary -Target org for the bundle installation. +Username or alias of the org in which to install the package bundle version. Not required if the `target-org` configuration variable is already set. # flags.dev-hub-org.summary @@ -30,7 +26,7 @@ Org ID of the Dev Hub org where the bundle was created. # flags.dev-hub-org.description -Specify the Dev Hub org ID directly (such as 00Dxx0000000000). +Enter the Dev Hub org ID, such as 00Dxx0000000000. # flags.wait.summary @@ -38,11 +34,11 @@ Number of minutes to wait for the installation to complete. # flags.verbose.summary -Display extended installation detail. +Display extended details about the installation. # requestInProgress -Installing bundle. +Installing package bundle. # bundleInstallWaitingStatus diff --git a/messages/bundle_install_list.md b/messages/bundle_install_list.md index 87893af8..b7d9144b 100644 --- a/messages/bundle_install_list.md +++ b/messages/bundle_install_list.md @@ -8,7 +8,7 @@ Shows the details of each request to install a package bundle version in the tar All filter parameters are applied using the AND logical operator (not OR). -To get information about a specific request, run "<%= config.bin %> package bundle install report" and supply the request ID. +To get information about a specific request, run "<%= config.bin %> package bundle install report" and enter the request ID. # flags.status.summary @@ -16,11 +16,11 @@ Status of the installation request, used to filter the list. # flags.verbose.summary -Displays additional information at a slight performance cost, such as validation text for each package bundle install request. +Display additional information, such as the validation text for each package bundle installation request. # flags.created-last-days.summary -Number of days since the request was created, starting at 00:00:00 of first day to now. Use 0 for today. +Number of days since the request was created, starting at 0. Use 0 for today. # examples @@ -30,17 +30,17 @@ Number of days since the request was created, starting at 00:00:00 of first day - List package bundle installation requests from the last 3 days in the Dev Hub org with username devhub@example.com: - <%= config.bin %> <%= command.id %> --created-last-days 3 --target-dev-hub + <%= config.bin %> <%= command.id %> --created-last-days 3 --target-dev-hub devhub@example.com -- List package bundle installation requests with status Error: +- List package bundle installation requests with the Error status: <%= config.bin %> <%= command.id %> --status Error -- List package bundle installation requests with status Queued: +- List package bundle installation requests with the Queued status: <%= config.bin %> <%= command.id %> --status Queued -- List package bundle installation requests with status Success that were created today: +- List package bundle install requests from today with the Success status: <%= config.bin %> <%= command.id %> --created-last-days 0 --status Success diff --git a/messages/bundle_install_report.md b/messages/bundle_install_report.md index dd687597..8aeaa70e 100644 --- a/messages/bundle_install_report.md +++ b/messages/bundle_install_report.md @@ -4,21 +4,17 @@ Report on the status of a package bundle installation request. # description -Use this command to check the status of a package bundle installation request. The command returns information about the request, including its current status and details about the package bundle version being installed. +The command returns information such as the current status of the request and details about the package bundle version being installed. -# examples +# examples - Report on a package bundle installation request: <%= config.bin %> <%= command.id %> --package-install-request-id 0Ho0x0000000000000 -- Report on a package bundle installation request using an alias: - - <%= config.bin %> force:package:bundle:install:report -i 0Ho0x0000000000000 - # flags.package-install-request-id.summary -The ID of the package bundle installation request to report on. +ID of the package bundle installation request to report on. # id @@ -38,9 +34,9 @@ Development Organization # validation-error -Validation Error +Validation Error -# created-date +# created-date Created Date diff --git a/messages/bundle_list.md b/messages/bundle_list.md index 26bd0921..95298408 100644 --- a/messages/bundle_list.md +++ b/messages/bundle_list.md @@ -4,13 +4,13 @@ List all package bundles in the Dev Hub org. # examples -List all package bundles in the specified Dev Hub org; uses the Dev Hub org with the username devhub@example.com: +- List all package bundles in the Dev Hub org with the username `devhub@example.com`: -sf package bundle list --target-dev-hub + <%= config.bin %> <%= command.id %> --target-dev-hub devhub@example.com -# namespace +# namespace -Namespace Prefix +Namespace Prefix # name @@ -18,15 +18,15 @@ Name # id -Id +ID # bundle-id -Package Bundle Id +Package Bundle ID # alias -Alias +Alias # description @@ -34,7 +34,7 @@ Description # flags.verbose.summary -Display extended bundle detail. +Display extended details about the package bundles. # error-notification-username @@ -42,4 +42,4 @@ Error Notification Username # createdBy -Created By +Created By diff --git a/messages/bundle_version_create.md b/messages/bundle_version_create.md index 933ca834..26c1c15c 100644 --- a/messages/bundle_version_create.md +++ b/messages/bundle_version_create.md @@ -4,25 +4,29 @@ Create a new package bundle version. # description -Create a new version of a package bundle with the specified components. +Before you create a new bundle version, create a definition file (similar to a scratch org definition file) that contains the list of package versions to include in the bundle. The definition file must be JSON and you must specify the package versions in the correct order of installation. The package bundle version is based on package versions listed in the definition file. +After the first bundle version that you create, make sure to update the version number in the sfdx-project.json file for subsequent bundle versions. + +To retrieve details about a package bundle version create request, including status and package bundle version ID (04t), run "sf package version create report -i 08c...". + # examples -Create a new version of a package bundle: +- Create a package bundle version in the Dev Hub org; uses the Dev Hub org with the username devhub@example.com: -sf package bundle version create -b MyBundle -p path/to/definition.json + <%= config.bin %> <%= command.id %> --bundle “Your bundle name” --definition-file resources/definition.json --target-dev-hub devhub@example.com # flags.bundle.summary -The name or ID of the package bundle to create a version for. +Name or ID of the package bundle to create a version for. # flags.definition-file.summary -Path to the JSON file containing the list of components to include in the bundle version. +Path to a definition file, similar to a scratch org definition file, that contains the list of package versions to include in the bundle. # flags.wait.summary -Number of minutes to wait for the command to complete before timing out. +Number of minutes to wait for the package bundle version to be created. # flags.verbose.summary @@ -46,24 +50,24 @@ Waiting for bundle version creation to complete. %s minutes remaining. Current s # bundleVersionCreateFinalStatus -Package Bundle version creation completed with status: %s +Package bundle version creation completed with status: %s # multipleErrors -The following errors occurred during bundle version creation: +The following errors occurred during package bundle version creation: %s # InProgress -Bundle version creation is %s. Use 'sf package bundle version create report -i %s' to check the status later. +Package bundle version creation is %s. Use "sf package bundle version create report -i %s" to check the status later. # requestInProgress -Creating bundle version... +Creating package bundle version... # packageVersionCreateFinalStatus -Package Bundle version creation completed with status: %s +Package bundle version creation completed with status: %s # packageVersionCreatePerformingValidations @@ -71,4 +75,4 @@ Performing validations on the package bundle version... # bundleVersionCreateSuccess -Successfully created bundle version for bundle %s +Successfully created package bundle version for bundle %s diff --git a/messages/bundle_version_create_list.md b/messages/bundle_version_create_list.md index 35a43639..e350061f 100644 --- a/messages/bundle_version_create_list.md +++ b/messages/bundle_version_create_list.md @@ -8,23 +8,23 @@ Shows the details of each request to create a package bundle version in the Dev All filter parameters are applied using the AND logical operator (not OR). -To get information about a specific request, run "<%= config.bin %> package bundle version create report" and supply the request ID. +To get information about a specific request, run "<%= config.bin %> package bundle version create report" and enter the request ID. # flags.status.summary -Status of the version creation request, used to filter the list. +Status of the installation request, used to filter the list. # flags.show-conversions-only.summary -Filter the list output to display only converted package bundle version. +Filter the list to display only converted package bundle versions. # flags.verbose.summary -Displays additional information at a slight performance cost, such as the version name and number for each package version create request. +Display additional information, such as the version name and number for each package bundle version creation request. # flags.created-last-days.summary -Number of days since the request was created, starting at 00:00:00 of first day to now. Use 0 for today. +Number of days since the request was created, starting at 0. Use 0 for today. # examples @@ -32,19 +32,19 @@ Number of days since the request was created, starting at 00:00:00 of first day <%= config.bin %> <%= command.id %> -- List package bundle version creation requests from the last 3 days in the Dev Hub org with username devhub@example.com: +- List package bundle version creation requests from the last three days in the Dev Hub org with the username devhub@example.com: - <%= config.bin %> <%= command.id %> --created-last-days 3 --target-dev-hub + <%= config.bin %> <%= command.id %> --created-last-days 3 --target-dev-hub devhub@example.com -- List package bundle version creation requests with status Error: +- List package bundle version creation requests with the Error status: <%= config.bin %> <%= command.id %> --status Error -- List package bundle version creation requests with status Queued: +- List package bundle version creation requests with the Queued status: <%= config.bin %> <%= command.id %> --status Queued -- List package bundle version creation requests with status Success that were created today: +- List package bundle version creation requests from today with the Success status: <%= config.bin %> <%= command.id %> --created-last-days 0 --status Success @@ -58,11 +58,11 @@ Status # package-id -Package Bundle Id +Package Bundle ID # packageVersionId -Package Bundle Version Id +Package Bundle Version ID # createdBy @@ -70,4 +70,4 @@ Created By # convertedFromVersionId -Converted From Version Id +Converted From Version ID diff --git a/messages/bundle_version_create_report.md b/messages/bundle_version_create_report.md index aaa9226d..cdf0949d 100644 --- a/messages/bundle_version_create_report.md +++ b/messages/bundle_version_create_report.md @@ -4,21 +4,17 @@ Report on the status of a package bundle version creation request. # description -Use this command to check the status of a package bundle version creation request. The command returns information about the request, including its current status and details about the package bundle version being created. +The command returns information such as the request's current status and details about the package bundle version being created. -# examples +# examples - Report on a package bundle version creation request: <%= config.bin %> <%= command.id %> --package-create-request-id 0Ho0x0000000000000 -- Report on a package bundle version creation request using an alias: - - <%= config.bin %> force:package:bundle:version:create:report -i 0Ho0x0000000000000 - # flags.bundle-version-create-request-id.summary -The ID of the package bundle version creation request to report on. +ID of the package bundle version creation request to report on. # id @@ -36,11 +32,11 @@ Package Bundle ID Package Bundle Version ID -# version-name +# version-name Version Name -# created-date +# created-date Created Date diff --git a/messages/bundle_version_list.md b/messages/bundle_version_list.md index c20fc6b4..585da22a 100644 --- a/messages/bundle_version_list.md +++ b/messages/bundle_version_list.md @@ -4,9 +4,9 @@ List all package bundle versions in the Dev Hub org. # examples -List package bundle versions in the Dev Hub org with the username devhub@example.com: +- List package bundle versions in the Dev Hub org with the username devhub@example.com: -sf package bundle version list --bundle “Your bundle name or ID” --target-dev-hub devhub@example.com + <%= config.bin %> <%= command.id %> --target-dev-hub devhub@example.com # namespace @@ -15,14 +15,14 @@ Namespace Prefix # name Name - + # id -Id +ID # bundle-id -Package Bundle Id +Package Bundle ID # alias @@ -34,7 +34,7 @@ Description # flags.verbose.summary -Display extended bundle detail. +Display extended details about the package bundle versions. # error-notification-username diff --git a/messages/bundle_version_report.md b/messages/bundle_version_report.md index 32529e91..063d70f6 100644 --- a/messages/bundle_version_report.md +++ b/messages/bundle_version_report.md @@ -1,17 +1,17 @@ # summary -Retrieve details about a package bundle version in the Dev Hub org. +Retrieve details about a specific package bundle version. # examples -Retrieve details about the package bundle version; uses the Dev Hub org with the username devhub@example.com: +- Retrieve details about the package bundle version; uses the Dev Hub org with the username devhub@example.com: -sf package bundle version report --bundle-version "Your bundle version name or ID" --target-dev-hub devhub@example.com + <%= config.bin %> <%= command.id %> --bundle-version "Your bundle version name or ID" --target-dev-hub devhub@example.com # flags.bundle-version.summary -ID of the package bundle version to retrieve details for. +Name or ID of the package bundle version to retrieve details about. # flags.verbose.summary -Display extended package bundle version details. +Display extended details about the package bundle version. diff --git a/messages/package_bundle_delete.md b/messages/package_bundle_delete.md index 5e6f5cfc..caa2ec83 100644 --- a/messages/package_bundle_delete.md +++ b/messages/package_bundle_delete.md @@ -4,9 +4,7 @@ Delete a package bundle. # description -Specify the ID or alias of the package bundle you want to delete. - -Delete package bundles. Before you delete a package bundle, first delete all associated package bundle versions. +Specify the ID or alias of the package bundle you want to delete. Before you delete a package bundle, first delete all associated package bundle versions. # examples @@ -34,7 +32,7 @@ Do you want to continue? (y/n) # prompt-delete-deny -The request to delete this package bundle was canceled +The request to delete this package bundle was canceled. # humanSuccess diff --git a/test/commands/bundle/packageBundleVersionCreate.test.ts b/test/commands/bundle/packageBundleVersionCreate.test.ts index c60b6c1a..a892a297 100644 --- a/test/commands/bundle/packageBundleVersionCreate.test.ts +++ b/test/commands/bundle/packageBundleVersionCreate.test.ts @@ -213,7 +213,7 @@ describe('package:bundle:version:create - tests', () => { expect(warnStub.callCount).to.equal(0); expect(logStub.callCount).to.equal(1); expect(logStub.args[0]).to.deep.equal([ - "Bundle version creation is Queued. Use 'sf package bundle version create report -i 08c3i000000fylgBBB' to check the status later.", + 'Package bundle version creation is Queued. Use "sf package bundle version create report -i 08c3i000000fylgBBB" to check the status later.', ]); }); @@ -231,7 +231,7 @@ describe('package:bundle:version:create - tests', () => { } catch (e) { const msg = (e as Error).message.replace(/\r\n/g, '\n'); expect(msg).to.equal( - 'The following errors occurred during bundle version creation:\n' + + 'The following errors occurred during package bundle version creation:\n' + 'PropertyController: Invalid type: Schema.Property__c\n' + 'SampleDataController: Invalid type: Schema.Property__c\n' + 'SampleDataController: Invalid type: Schema.Broker__c'