← docsDocumentation

/changelog-generator

Batch changelog across version ranges.

Batch changelog generation across multiple releases or tags. Handles version ranges, groups entries by semantic version, and produces formatted output for release documentation.

Category

Documentation

Execution

Tag range → formatted changelog

Goal

Generate formatted changelogs across multiple version ranges.

Scope

Applies to

  • +Multi-version releases
  • +Backfilling changelogs
  • +Release documentation

Does not cover

  • −Single-commit messages
  • −PR descriptions

Triggers

"Generate changelogs for all versions""Batch changelog""Create release notes for v1 to v5"

Inputs

  • →Version tags or ranges
  • →Output format (markdown, HTML)
  • →Audience per section

Invariants

  • 01Each version section must have its own commit range
  • 02Format must be consistent across versions

Procedure

  1. Step 1Enumerate version tags
  2. Step 2For each range, run changelog workflow
  3. Step 3Combine into single document with version headers
  4. Step 4Format and output

Outputs

  • ▸Combined changelog document with version sections
  • ▸Per-version commit summaries

Review Gate

  • [ ]Every version tag is represented
  • [ ]Consistent formatting
  • [ ]No gaps in version history