[pjfanning]

Motivation

Several PRs merged after the 2.0.0 release notes PR (#3606) were not yet in the release notes or the 1.x to 2.x migration guide. Both pages had also grown into long flat lists that are hard to scan.

Modification

Release notes (releases-2.0.md)

• Add the missing merges: fix: handle Artery uid collisions gracefully and make system uids more unique #3652 (Artery uid collisions), feat: improve EventWriter: fill sequence number gaps, handle lookup failures and snapshot events, bypass the circuit breaker #3653 (EventWriter), fix: report the effective timeout in shard hand off stop warnings #3644 (hand off timeout warnings), fix: fail fast when both Jackson serializer modules are on the classpath #3673 (fail fast with both Jackson modules), Fix ScalaPB generated-message deserialization #3665 (ScalaPB deserialization fix, added to the feat: optionally bind ScalaPB messages to the protobuf serializer #3651 entry), Add zstd compression and decompression for pekko streams (heap buffer APIs) #3639 (zstd stream operators; the zstd-jni dependency note now covers them too) and the docs PRs Clarify mutable state updates in typed persistence #3655, Document and test EventStream type-based subscription semantics #3658, Document migration from removed SSLConfig convenience APIs #3660, Separate build-tool and language selectors in documentation #3663, Clarify ActorContext and Behavior lifecycles #3664.
• Add a serialization highlight to Main changes (marker traits, zstd, ScalaPB binding).
• Move Security Hardening ahead of Bug Fixes.
• Add the later merges: the Java DSL wildcard bounds series (Widen Java DSL parameters with wildcard bounds and Iterable #3713, Widen more Java DSL parameters with wildcard bounds #3714, Widen Java DSL function and CompletionStage parameters with wildcard bounds #3717, Widen stream-typed Java DSL function parameters with wildcard bounds #3718, Widen Java DSL graph element types and function results with wildcard bounds #3719, Widen typed Java DSL function parameters with wildcard bounds #3720) to Main changes and API changes, Use CompletionStage in the AbstractShardAllocationStrategy Java API #3677 and Add ReplyEffectWithStop for staged reply-and-stop composition #3682 to API changes, Recreate stopped sharding replicators on later starts #3700 and fix: answer conductor socket address queries asynchronously (#3693) #3707 to Bug Fixes, Tell a peer with a colliding Artery uid that it is quarantined #3676 to the Artery uid collision entry and Add a zstd decompression window limit #3710 / Update zstd-jni to 1.5.7-25 and call setLongMax directly #3721 (zstd decompression window limit, needing zstd-jni 1.5.7-25) to the zstd operators entry. Update the zstd-jni (Update zstd-jni to 1.5.7-25 and call setLongMax directly #3721) and aeron (Update aeron-client, aeron-driver to 1.54.0 #3723) versions in Dependency Changes.
• Add the TLS fixes: Wait for transport demand instead of failing when TLS unwrap needs a wrap #3732 #3734 (Stuck in unwrap loop in both TLS engines) to Bug Fixes, and Preserve accepted TLS plaintext on output cancellation #3727, Fix TLS GraphStage buffer allocation and growth #3728, Keep draining TLS plaintext after a TLS 1.3 peer close_notify #3731, Keep draining TLS plaintext after a TLS 1.3 KeyUpdate #3738 to the GraphStage TLS engine entry in Additions. Add Avoid quadratic cursor scans in fanout publishers #3730 (fanout publisher cursor scans) to Performance and Log failed lease releases when a Shard stops #3705 #3733 (log failed shard lease releases) to the shard lease entry.
• Drop Preserve Runnable hash codes in PekkoForkJoinTask #3668 from the Mailbox entry, since Revert "Preserve Runnable hash codes in PekkoForkJoinTask" (#3668) #3681 reverted it.
• Group Bug Fixes, Ported from Akka, Additions and Changes by module, using bold labels rather than headings so the page TOC stays short. No other entries were dropped: apart from Preserve Runnable hash codes in PekkoForkJoinTask #3668, every PR/issue link on main is still there.

Migration guide (migration-guide-1.x-2.x.md)

• Group the breaking changes by area: Java API, Actors, Streams, TLS, Remoting, Cluster Sharding and Persistence.
• Add the Java DSL pekko.japi.Function removal and the Scala types replaced in Java APIs. Until now these were only in the release notes.
• Move the PekkoSSLConfig migration from Document migration from removed SSLConfig convenience APIs #3660 out of Dependency Changes into a TLS section and break it into steps.
• Move the Use CompletionStage in the AbstractShardAllocationStrategy Java API #3677 shard allocation strategy note (added on main under Persistence) to Cluster Sharding.
• Add the Add ReplyEffectWithStop for staged reply-and-stop composition #3682 ReplyEffectWithStop change (stash().thenStop() no longer compiles) to Persistence.
• Split the SerializedEvent note into its own bullet, and point to the single Jackson module rule from Dependency Changes.

Result

The 2.0.0 docs cover everything merged so far and are easier to read.

Tests

• Not run - docs only

References

Refs #3606