Skip to content

Commit 2361727

Browse files
committed
docs: warn about binary compatibility and other Pekko modules in 2.0.0 release notes
1 parent 3097c62 commit 2361727

1 file changed

Lines changed: 11 additions & 2 deletions

File tree

‎docs/src/main/paradox/release-notes/releases-2.0.md‎

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,17 @@ Apache Pekko 2.0.x releases support Java 17 and above.
44

55
## 2.0.0
66

7-
Apache Pekko 2.0.0 is a new major release. It is not binary compatible with Pekko 1.x and it also has some source
8-
incompatible changes. Please read the @ref:[Migration Guide](../migration/migration-guide-1.x-2.x.md) before upgrading.
7+
@@@ warning
8+
9+
Apache Pekko 2.0.0 is a new major release. Do not assume binary compatibility with Pekko 1.x: libraries built
10+
against Pekko 1.x need to be rebuilt against Pekko 2.0.0, and some code will need source changes. Please read the
11+
@ref:[Migration Guide](../migration/migration-guide-1.x-2.x.md) before upgrading.
12+
13+
It could take months for the other Pekko modules, such as Pekko HTTP, Pekko Connectors, Pekko gRPC, Pekko Management
14+
and the persistence plugins, to have 2.0.0 releases. Until then, users might be able to use the 2.0.0 milestone
15+
releases of those modules with Pekko 2.0.0, but you should test very carefully before relying on this in production.
16+
17+
@@@
918

1019
The changes in this release were previewed in a series of milestone releases. See the GitHub milestones for
1120
[2.0.0-M1](https://github.com/apache/pekko/milestone/5?closed=1),

0 commit comments

Comments
 (0)