changelog gh-release cli command

docs-builder changelog gh-release <repo> [<version>] [options]

Create changelog entries from the PRs referenced in a GitHub release.

Arguments

<repo> string required

Required: GitHub repository in owner/repo format (e.g., "elastic/elasticsearch" or just "elasticsearch" which defaults to elastic/elasticsearch)

<version> string

Optional: Version tag to fetch (e.g., "v9.0.0", "9.0.0"). Defaults to "latest"

Default: latest

Options

--config string

Optional: Path to the changelog.yml configuration file. Defaults to 'docs/changelog.yml'

Constraints: symbolic links not allowed, must exist, extensions: yml, yaml, supports ~ home expansion

--description string

Optional: Bundle description text with placeholder support. Supports VERSION, LIFECYCLE, OWNER, and REPO placeholders. Overrides bundle.description from config.

--output string

Optional: Output directory for changelog files. Falls back to bundle.directory in changelog.yml when not specified. Defaults to './changelogs'

--release-date string

Optional: Explicit release date for the bundle in YYYY-MM-DD format. Overrides GitHub release published date.

--[no-]strip-title-prefix

Optional: Remove square brackets and text within them from the beginning of PR titles (e.g., "[Inference API] Title" becomes "Title")

Default: false

--[no-]warn-on-type-mismatch

Optional: Warn when the type inferred from release notes section headers doesn't match the type derived from PR labels. Defaults to true

Default: false

-l --log-level enum

Minimum log level.

Values: trace, debug, information, warning, error, critical, none

Default: information

-c --config-source enum

Override the configuration source: local, remote

Values: local, remote, embedded

--[no-]skip-private-repositories

Skip cloning private repositories