Skip to content

Add highlights and upgrade notes to 5.0.0-M1 release notes#1182

Merged
merlimat merged 1 commit into
mainfrom
improve-5.0.0-m1-release-notes
Jun 23, 2026
Merged

Add highlights and upgrade notes to 5.0.0-M1 release notes#1182
merlimat merged 1 commit into
mainfrom
improve-5.0.0-m1-release-notes

Conversation

@merlimat

Copy link
Copy Markdown
Contributor

Motivation

The Pulsar 5.0.0-M1 release notes were a flat list of ~350 PRs with no overview or upgrade guidance. For a major milestone, a reader had no way to tell what matters or what to watch out for when upgrading.

Changes

Two additive sections at the top of release-notes/versioned/pulsar-5.0.0-M1.md (the detailed per-category PR lists are left unchanged):

  • Intro + announcement link — frames M1 as a preview (not for production) and links the announcement blog post, matching the 4.0.0 convention.
  • ### Highlights — narrative summary of the major themes, each with PIP links, ordered by significance:
    • Scalable Topics (Topics v5), the new V5 Java client API, Oxia as the recommended metadata store, Maven→Gradle build migration, IO connector repository split, structured logging, API/platform modernization, and security/dependency updates.
  • ### Important notice — breaking changes to review before upgrading: javax.*jakarta.*, Etcd backend removal, IO connector relocation, Gradle build, and fastutil removal.

This follows the conventions already used by the 4.0.0 (highlights + announcement link) and 2.11.0 (important notice) release notes.

Notes

All descriptions are sourced from the corresponding PIPs and the official 5.0.0-M1 announcement post; all PIP/blog links were verified to resolve.

The 5.0.0-M1 release notes were a flat list of ~350 PRs with no overview
or upgrade guidance. Add a Highlights section summarizing the major themes
(Scalable Topics / Topics v5, the V5 Java client, Oxia as the recommended
metadata store, the Maven-to-Gradle build migration, the IO connector
repository split, and structured logging) and an Important notice section
covering the breaking changes (javax to jakarta, Etcd backend removal,
connector relocation, Gradle build, fastutil removal).

Follows the conventions already used by the 4.0.0 (highlights + announcement
link) and 2.11.0 (important notice) release notes. The detailed per-category
PR lists are unchanged.
@merlimat merlimat merged commit 61b060a into main Jun 23, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant