This is an automated email from the ASF dual-hosted git repository.
pjfanning pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/pekko.git
The following commit(s) were added to refs/heads/main by this push:
new 872034db3f add stub doc describing migrating to pekko 2 (#3355)
872034db3f is described below
commit 872034db3ff728a443a68f89fc5c8a3323ec4a27
Author: PJ Fanning <[email protected]>
AuthorDate: Wed Jul 15 20:25:09 2026 +0100
add stub doc describing migrating to pekko 2 (#3355)
* add stub doc describing migrating to pekko 2
* Update migration-guide-1.x-2.x.md
---
docs/src/main/paradox/migration/index.md | 1 +
.../paradox/migration/migration-guide-1.x-2.x.md | 35 ++++++++++++++++++++++
2 files changed, 36 insertions(+)
diff --git a/docs/src/main/paradox/migration/index.md
b/docs/src/main/paradox/migration/index.md
index d4e9235e39..79589e64f8 100644
--- a/docs/src/main/paradox/migration/index.md
+++ b/docs/src/main/paradox/migration/index.md
@@ -10,5 +10,6 @@ project.description: Apache Pekko version migration guides.
* [Migration Guide from Akka to Apache Pekko
1.0.x](migration-guide-akka-1.0.x.md)
* [Migration Guide from Apache Pekko 1.0.x to
1.1.x](migration-guide-1.0.x-1.1.x.md)
+* [Migration Guide from Apache Pekko 1.x to 2.x](migration-guide-1.x-2.x.md)
@@@
diff --git a/docs/src/main/paradox/migration/migration-guide-1.x-2.x.md
b/docs/src/main/paradox/migration/migration-guide-1.x-2.x.md
new file mode 100644
index 0000000000..0355511f17
--- /dev/null
+++ b/docs/src/main/paradox/migration/migration-guide-1.x-2.x.md
@@ -0,0 +1,35 @@
+---
+project.description: Migrating to Apache Pekko 2.0.
+---
+# Migration from Apache Pekko 1.x to 2.x
+
+Apache Pekko 2.x is not @ref:[Binary
Compatible](../common/binary-compatibility-rules.md) with Apache Pekko 1.x.
+
+The major difference is that some deprecated code has been removed but there
are also a small number of
+breaking changes where deprecation was not feasible.
+
+It is possible that some simple code compiled with Pekko 1.x libs will work
with Pekko 2.x but you should not
+rely on this.
+
+Pekko 1.x is still maintained and major bugs will be fixed in it.
+
+## Start by upgrading to latest Pekko 1.x releases
+
+Some of the changes in Pekko 2.x have been backported although these changes
are normally only done when they fix
+important bugs.
+
+Some additional code has been deprecated in the most recent 1.x releases and
the compile warnings will help you with
+moving onto better supported APIs.
+
+## Change any code that relies on deprecated APIs in Pekko 1.x
+
+Not every deprecated API has been removed in Pekko 2.x but many have been.
+
+Java API users may find that they have more deprecations to deal with because
the Scala API is more stable and there
+were a few mistakes in the Java API where Scala classes leaked into some of
the Java API methods.
+
+## Additional Breaking Changes in Pekko 2.x
+
+An example is in the Scala DSL for Flow and Source, the `watchTermination`
function call no longer needs an empty param
+list before a second param list. Instead of `watchTermination(){ ... }`, you
now must use `watchTermination{ ... }`.
+([PR2378](https://github.com/apache/pekko/pull/2378))
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
