diff --git a/docs/cli.md b/docs/cli.md index d6a6abedd..f688d41db 100644 --- a/docs/cli.md +++ b/docs/cli.md @@ -39,33 +39,34 @@ release-please bootstrap \ Extra options: -| Option | Type | Description | -| ------ | ---- | ----------- | -| `--config-file` | `string` | Override the path to the release-please config file. Defaults to `release-please-config.json` | -| `--manifest-file` | `string` | Override the path to the release-please manifest file. Defaults to `.release-please-manifest.json` | -| `--path` | `string` | Path for changes to consider part of this component's release. Defaults to `.` Other paths should be relative to the repository root and not include `.` | -| `--package-name` | `string` | Name of the package being released. Defaults to a value determined by the configured release type | -| `--component` | `string` | Name of the component used for branch naming and release tagging. Defaults to a normalized version based on the package name | -| `--release-type` | [`ReleaseType`](/docs/customizing.md#strategy-language-types-supported) | Language strategy that determines which files to update | -| `--initial-version` | `string` | Version string to set as the last released version of this package. Defaults to `0.0.0` | -| `--versioning-strategy` | [`VersioningStrategyType`](/docs/customizing.md#versioning-strategies) | Override method of determining SemVer version bumps based on commits. Defaults to `default` | -| `--bump-minor-pre-major` | `boolean` | Configuration option for the versioning strategy. If set, will bump the minor version for breaking changes for versions < 1.0.0 | -| `--bump-patch-for-minor-pre-major` | `boolean` | Configuration option for the versioning strategy. If set, will bump the patch version for features for versions < 1.0.0 | -| `--prerelease-type` | `string` | Configuration option for the prerelease versioning strategy. If prerelease strategy used and type set, will set the prerelease part of the version to the provided value in case prerelease part is not present. | -| `--draft` | `boolean` | If set, create releases as drafts | -| `--prerelease` | `boolean` | If set, create releases that are pre-major or pre-release version marked as pre-release on Github| -| `--draft-pull-request` | `boolean` | If set, create pull requests as drafts | -| `--label` | `string` | Comma-separated list of labels to apply to the release pull requests. Defaults to `autorelease: pending` | -| `--release-label` | `string` | Comma-separated list of labels to apply to the pull request after the release has been tagged. Defaults to `autorelease: tagged` | -| `--changelog-path` | `string` | Override the path to the managed CHANGELOG. Defaults to `CHANGELOG.md` | -| `--changelog-type` | [`ChangelogType`](/docs/customizing.md#changelog-types) | Strategy for building the changelog contents. Defaults to `default` | -| `--changelog-sections` | `string` | Comma-separated list of commit scopes to show in changelog headings | -| `--changelog-host` | `string` | Host for commit hyperlinks in the changelog. Defaults to `https://github.com` | -| `--pull-request-title-pattern` | `string` | Override the pull request title pattern. Defaults to `chore${scope}: release${component} ${version}` | -| `--pull-request-header` | `string` | Override the pull request header. Defaults to `:robot: I have created a release *beep* *boop*` | -| `--pull-request-footer` | `string` | Override the pull request footer. Defaults to `This PR was generated with Release Please. See documentation.` | -| `--extra-files` | `string[]` | Extra file paths for the release strategy to consider | -| `--version-file` | `string` | Ruby only. Path to the `version.rb` file | +| Option | Type | Description | +|------------------------------------|-------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `--config-file` | `string` | Override the path to the release-please config file. Defaults to `release-please-config.json` | +| `--manifest-file` | `string` | Override the path to the release-please manifest file. Defaults to `.release-please-manifest.json` | +| `--path` | `string` | Path for changes to consider part of this component's release. Defaults to `.` Other paths should be relative to the repository root and not include `.` | +| `--package-name` | `string` | Name of the package being released. Defaults to a value determined by the configured release type | +| `--component` | `string` | Name of the component used for branch naming and release tagging. Defaults to a normalized version based on the package name | +| `--release-type` | [`ReleaseType`](/docs/customizing.md#strategy-language-types-supported) | Language strategy that determines which files to update | +| `--initial-version` | `string` | Version string to set as the last released version of this package. Defaults to `0.0.0` | +| `--versioning-strategy` | [`VersioningStrategyType`](/docs/customizing.md#versioning-strategies) | Override method of determining SemVer version bumps based on commits. Defaults to `default` | +| `--bump-minor-pre-major` | `boolean` | Configuration option for the versioning strategy. If set, will bump the minor version for breaking changes for versions < 1.0.0 | +| `--bump-patch-for-minor-pre-major` | `boolean` | Configuration option for the versioning strategy. If set, will bump the patch version for features for versions < 1.0.0 | +| `--prerelease-type` | `string` | Configuration option for the prerelease versioning strategy. If prerelease strategy used and type set, will set the prerelease part of the version to the provided value in case prerelease part is not present. | +| `--draft` | `boolean` | If set, create releases as drafts | +| `--prerelease` | `boolean` | If set, create releases that are pre-major or pre-release version marked as pre-release on Github | +| `--draft-pull-request` | `boolean` | If set, create pull requests as drafts | +| `--label` | `string` | Comma-separated list of labels to apply to the release pull requests. Defaults to `autorelease: pending` | +| `--release-label` | `string` | Comma-separated list of labels to apply to the pull request after the release has been tagged. Defaults to `autorelease: tagged` | +| `--changelog-path` | `string` | Override the path to the managed CHANGELOG. Defaults to `CHANGELOG.md` | +| `--changelog-type` | [`ChangelogType`](/docs/customizing.md#changelog-types) | Strategy for building the changelog contents. Defaults to `default` | +| `--changelog-sections` | `string` | Comma-separated list of commit scopes to show in changelog headings | +| `--changelog-host` | `string` | Host for commit hyperlinks in the changelog. Defaults to `https://github.com` | +| `--pull-request-title-pattern` | `string` | Override the pull request title pattern. Defaults to `chore${scope}: release${component} ${version}` | +| `--pull-request-header` | `string` | Override the pull request header. Defaults to `:robot: I have created a release *beep* *boop*` | +| `--pull-request-footer` | `string` | Override the pull request footer. Defaults to `This PR was generated with Release Please. See documentation.` | +| `--component-no-space` | `boolean` | release-please automatically adds ` ` (space) in front of parsed ${component}. This option indicates whether that behaviour should be disabled. Defaults to `false` | +| `--extra-files` | `string[]` | Extra file paths for the release strategy to consider | +| `--version-file` | `string` | Ruby only. Path to the `version.rb` file | ## Creating/updating release PRs diff --git a/docs/customizing.md b/docs/customizing.md index 3f290f5d1..fb78b83d5 100644 --- a/docs/customizing.md +++ b/docs/customizing.md @@ -101,7 +101,12 @@ title or body format). The default pull request title uses this pattern: `chore${scope}: release${component} ${version}` so a common release pull -request title would be `chore(main): release foo-bar v1.2.3`. +request title would be `chore(main): release foo-bar v1.2.3`. +Please note that `${component}` will be parsed to ` ${component}` (With space in front of). +If you wish to avoid that, consider using `componentNoSpace: true` configuration parameter. + +> [!WARNING] +> Setting this option when release PR already exists might break the parsing resulting in another PR being opened. | Pattern | Description | | ------- | ----------- |