Skip to content

Update changelog with rule changes since 2024-06-27#857

Open
SmilyOrg wants to merge 4 commits intomainfrom
feature/update-changelog-2025
Open

Update changelog with rule changes since 2024-06-27#857
SmilyOrg wants to merge 4 commits intomainfrom
feature/update-changelog-2025

Conversation

@SmilyOrg
Copy link
Member

@SmilyOrg SmilyOrg commented Feb 19, 2026

Summary

Updates the changelog with rule changes identified since the last manual entry (2024-06-27).

This PR demonstrates the changelog generation tool created in PR #856 and is intended to be merged after that PR.

Changes

Generated using make changelog, which automatically:

  1. Detected the latest changelog entry (2024-06-27)
  2. Analyzed commits since that date
  3. Identified rule changes
  4. Formatted and inserted them into the changelog

Dependencies

⚠️ Stacked PR: This PR depends on PR #856 (changelog generation tools)

PR #856 must be merged first to ensure the make changelog target is available.

Testing

The changelog entries were generated using the script and tool from PR #856:

make changelog

🤖 Generated with Claude Code

SmilyOrg and others added 3 commits February 19, 2026 17:42
Introduces a production-ready changelog generation system based on PR #816 discussion.

Features:
- scripts/changelog.sh: Automated script to generate changelog entries from git history
- scripts/changelog.prompt: AI prompt instructions for identifying rule changes
- Makefile target: 'make changelog' auto-detects latest entry and updates in place

The tool analyzes git commits for a specified time period, identifies rule-related
changes (filtering out formatting, infrastructure, and editorial changes), and formats
them as AsciiDoc changelog entries with proper cross-references and PR/commit links.

Usage:
  Direct: ./scripts/changelog.sh [OPTIONS]
  Make:   make changelog

Options:
  --raw              Show full AI analysis output
  --update           Write entries to chapters/changelog.adoc (default for make)
  --year YYYY        Generate for entire year
  --since YYYY-MM-DD Generate since specific date

By default (no args), auto-detects latest changelog entry and generates for
commits after that date.

Requirements:
  - zllm command installed (Zalando internal tool)
  - Git repository

Co-Authored-By: Claude Code <noreply@anthropic.com>
- Fix spelling: "producedure" → "procedure" in both changelog.prompt and chapters/changelog.adoc
- Fix shebang format to match project conventions (#! /bin/bash)
- Replace non-portable grep -oP with grep -E + sed for macOS compatibility
- Add error handling for missing "== Rule Changes" header before arithmetic operations

Co-Authored-By: Claude Code <noreply@anthropic.com>
Add a new section describing the changelog generation tool, its prerequisites,
and usage options to match existing documentation practices for other Makefile targets.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@SmilyOrg SmilyOrg added the minor Minor changes, e.g. low risk config updates, changes that do not introduce a new API call. label Feb 20, 2026
Generated using 'make changelog' which auto-detected the latest entry
(2024-06-27) and identified all rule changes since then.

Entries added:
- Separate compatibility rules for input/output schemas (<<108>>)
- Deprecate x-extensible-enum (<<112>>)
- Fix mixup of rules 250 and 251
- Upgrade to OpenAPI 3.1 (<<101>>)
- Clarify GET-with-body and pagination interaction (<<148>>, <<161>>)
- Allow proprietary headers for Transactions Checkout (<<183>>)
- Update RFC links in <<243>>
- Clarify status codes 502/504 documentation (<<243>>)
- Improve Deprecation header format (<<189>>)
@SmilyOrg SmilyOrg force-pushed the feature/update-changelog-2025 branch from a4d4436 to f6d5d7b Compare February 20, 2026 16:04
@SmilyOrg SmilyOrg changed the base branch from main to feature/changelog-generation-tool February 20, 2026 16:04
Base automatically changed from feature/changelog-generation-tool to main March 3, 2026 14:06
@tkrop tkrop marked this pull request as ready for review March 3, 2026 14:07
@tfrauenstein
Copy link
Member

@tkrop Will check and condense the change log history

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

minor Minor changes, e.g. low risk config updates, changes that do not introduce a new API call.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants