pjfanning commented on code in PR #249: URL: https://github.com/apache/incubator-pekko/pull/249#discussion_r1185936319
########## docs/src/main/paradox/project/migration-guides.md: ########## @@ -10,16 +10,29 @@ please [migrate to Akka 2.6](https://doc.akka.io/docs/akka/current/project/migra This is just stub documentation. It will be improved. -* for Pekko jar dependencies, the groupId is "org.apache.pekko" instead of "com.typesafe.akka" -* the jar names start with "pekko" instead of "akka" - e.g. pekko-actor_2.13.jar instead of akka-actor_2.13.jar +In your dependency management files: +* Update dependency Akka version to the latest version of Pekko `1.0.x`. +* for Pekko jar dependencies, the groupId is `org.apache.pekko` instead of `com.typesafe.akka` or `com.lightbend.akka.<package_name>` +* the jar names start with "pekko" instead of "akka" - e.g. pekko-actor_2.13.jar instead of akka-actor_2.13.jar * Alpakka equivalent is "pekko-connectors" - e.g. pekko-connectors-kafka_2.13.jar instead of alpakka-kafka_2.13.jar -* Pekko packages start with "org.apache.pekko" instead of "akka" - e.g. `import org.apache.pekko.actor` instead of `import akka.actor` -* Where class names have "Akka" in the name, the Pekko ones have "Pekko" - e.g. PekkoException instead of AkkaException -* Configs in `application.conf` use "pekko" prefix instead of "akka" + +In config files: +* Configs use `pekko` prefix instead of `akka` + +In source code files: +* Pekko packages start with `org.apache.pekko` instead of `akka` - e.g. `import org.apache.pekko.actor` instead of `import akka.actor` +* Where class names have "Akka" in the name, the Pekko ones have "Pekko" - e.g. `PekkoException` instead of `AkkaException` +* Configs use `pekko` prefix instead of `akka` + +In Documentation: +* Where appropriate, text should refer to `Pekko` instead of `Akka` +* URLs linking to files in https://doc.akka.io/docs/akka/ should instead point at https://pekko.apache.org/docs/pekko/ + * We have changed the default ports used by the pekko-remote module. -* With @ref:[Classic Remoting](../remoting.md), Akka defaults to 2552, while Pekko defaults to 7355. -* With @ref:[Artery Remoting](../remoting-artery.md), Akka defaults to 25520, while Pekko defaults to 17355. + * With @ref:[Classic Remoting](../remoting.md), Akka defaults to 2552, while Pekko defaults to 7355. + * With @ref:[Artery Remoting](../remoting-artery.md), Akka defaults to 25520, while Pekko defaults to 17355. +## TBC: We are still investigating the effects of how the package name changes affect the @ref:[Persistence](../persistence.md) Review Comment: See https://lists.apache.org/thread/v7c08l4bn66o4o2go0h7xzzl8pz0tr6p I can update this section in an independent PR -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
