[incubator-pekko-http] branch main updated: slightly more detailed migration guide (a placeholder) (#122)

[fa...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

fanningpj pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/incubator-pekko-http.git


The following commit(s) were added to refs/heads/main by this push:
     new fad15dd0a slightly more detailed migration guide (a placeholder) (#122)
fad15dd0a is described below

commit fad15dd0a9ae1583dbeb8b25de34a800b4dc8a60
Author: PJ Fanning <pj...@users.noreply.github.com>
AuthorDate: Wed Mar 15 15:08:44 2023 +0100

    slightly more detailed migration guide (a placeholder) (#122)
    
    * slightly more detailed migration guide (a placeholder)
    
    * Update index.md
---
 docs/src/main/paradox/migration-guide/index.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/src/main/paradox/migration-guide/index.md b/docs/src/main/paradox/migration-guide/index.md
index 658d7ed8e..4679e0ae1 100644
--- a/docs/src/main/paradox/migration-guide/index.md
+++ b/docs/src/main/paradox/migration-guide/index.md
@@ -3,4 +3,11 @@
 @@toc { depth=3 }
 
 * If you are currently using an old version of Akka HTTP or Spray, you should first follow the [Akka HTTP migration guide](https://doc.akka.io/docs/akka-http/10.2/migration-guide/index.html)
-* We will soon provide a guide for migrating from Akka HTTP v10.2 to Apache Pekko HTTP
+* The @extref:[migration guide](pekko-docs:project/migration-guides.html) for the core Apache Pekko libs is a useful guideline.
+* 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-http_2.13.jar instead of akka-http_2.13.jar
+* If you have a dependency akka-http2-support, Pekko does not need a separate jar. The support is built into main pekko-http jars.
+* Pekko packages start with "org.apache.pekko" instead of "akka" - e.g. `import org.apache.pekko.http` instead of `import akka.http`
+* 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"
+* We will soon provide a more detailed guide for migrating from Akka HTTP v10.2 to Apache Pekko HTTP


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@pekko.apache.org
For additional commands, e-mail: commits-help@pekko.apache.org