docs: revise URL structure (libraries) (#4425)

* docs: revise URL structure (libraries)
* Update current links

.algolia-search-index-config.json

@@ -2,7 +2,7 @@
   "index_name": "akka_http_docs",
   "start_urls": [
     {
-      "url": "https://doc.akka.io/docs/akka-http/current/",
+      "url": "https://doc.akka.io/libraries/akka-http/current/",
       "extra_attributes": {
         "language": [
           "scala",
@@ -41,4 +41,4 @@
     "299459375"
   ],
   "nb_hits": 1650
-}
+}

CONTRIBUTING.md

@@ -130,7 +130,7 @@ This allows simple and fast iterations on changes that would need to be introduc
 
 ## Binary compatibility
 Binary compatibility rules and guarantees are described in depth in the [Binary Compatibility Rules
-](https://doc.akka.io/docs/akka/current/common/binary-compatibility-rules.html) section of the documentation.
+](https://doc.akka.io/libraries/akka-core/current/common/binary-compatibility-rules.html) section of the documentation.
 
 Akka-http uses MiMa (which is short for [Lightbend Migration Manager](https://github.com/lightbend/migration-manager)) to
 validate binary compatibility of incoming Pull Requests. If your PR fails due to binary compatibility issues, you may see 
@@ -150,7 +150,7 @@ Situations when it may be fine to ignore a MiMa issued warning include:
 - if it is touching any class marked as `private[akka]`, `/** INTERNAL API*/` or similar markers
 - if it is concerning internal classes (often recognizable by package names like `dungeon`, `impl`, `internal` etc.)
 - if it is adding API to classes / traits which are only meant for extension by Akka itself, i.e. should not be extended by end-users
-- if it is touching any class marked with the `@InternalApi`, `@DoNotInherit`, and `@ApiMayChange`. See [API stability annotations and comments](https://doc.akka.io/docs/akka/current/common/binary-compatibility-rules.html#api-stability-annotations-and-comments)
+- if it is touching any class marked with the `@InternalApi`, `@DoNotInherit`, and `@ApiMayChange`. See [API stability annotations and comments](https://doc.akka.io/libraries/akka-core/current/common/binary-compatibility-rules.html#api-stability-annotations-and-comments)
 - other tricky situations
 
 If it turns out that the change can be safely ignored, please add the filter to a file with the issue number in the filename, placed in the submodule's `src/main/mima-filters/<last-released-version>.backwards.excludes` directory.

README.md

@@ -21,15 +21,15 @@ Documentation
 -------------
 
 The documentation is available at
-[doc.akka.io](https://doc.akka.io/docs/akka-http/current/), for
-[Scala](https://doc.akka.io/docs/akka-http/current/scala/http/) and
-[Java](https://doc.akka.io/docs/akka-http/current/java/http/).
+[doc.akka.io](https://doc.akka.io/libraries/akka-http/current/), for
+[Scala](https://doc.akka.io/libraries/akka-http/current/scala/http/) and
+[Java](https://doc.akka.io/libraries/akka-http/current/java/http/).
 
 
 Current versions of all Akka libraries
 --------------------------------------
 
-The current versions of all Akka libraries are listed on the [Akka Dependencies](https://doc.akka.io/docs/akka-dependencies/current/) page. Releases of the Akka HTTP libraries in this repository are listed on the [GitHub releases](https://github.com/akka/akka-http/releases) page.
+The current versions of all Akka libraries are listed on the [Akka Dependencies](https://doc.akka.io/libraries/akka-dependencies/current/) page. Releases of the Akka HTTP libraries in this repository are listed on the [GitHub releases](https://github.com/akka/akka-http/releases) page.
 
 
 Community

akka-http-core/src/main/resources/reference.conf

@@ -337,7 +337,7 @@ akka.http {
       #
       # It is also possible to provide a payload for each heartbeat message,
       # this setting can be configured programatically by modifying the websocket settings.
-      # See: https://doc.akka.io/docs/akka-http/current/server-side/websocket-support.html
+      # See: https://doc.akka.io/libraries/akka-http/current/server-side/websocket-support.html
       periodic-keep-alive-mode = ping
 
       # Interval for sending periodic keep-alives

akka-http-core/src/main/scala/akka/http/impl/engine/client/PoolInterface.scala

@@ -94,7 +94,7 @@ private[http] object PoolInterface {
     private[this] val PoolOverflowException = new BufferOverflowException( // stack trace cannot be prevented here because `BufferOverflowException` is final
       s"Exceeded configured max-open-requests value of [${poolId.hcps.setup.settings.maxOpenRequests}]. This means that the request queue of this pool (${poolId.hcps}) " +
         s"has completely filled up because the pool currently does not process requests fast enough to handle the incoming request load. " +
-        "Please retry the request later. See https://doc.akka.io/docs/akka-http/current/scala/http/client-side/pool-overflow.html for " +
+        "Please retry the request later. See https://doc.akka.io/libraries/akka-http/current/scala/http/client-side/pool-overflow.html for " +
         "more information.")
 
     val hcps = poolId.hcps

akka-http-core/src/main/scala/akka/http/javadsl/model/ws/UpgradeToWebSocket.scala

@@ -17,7 +17,7 @@ import akka.stream._
  * This low-level API is expected to be replaced by an Attribute in the future.
  *
  * In any case, you might want to use `handleWebSocketMessages` instead as documented
- * at https://doc.akka.io/docs/akka-http/current/server-side/websocket-support.html#routing-support
+ * at https://doc.akka.io/libraries/akka-http/current/server-side/websocket-support.html#routing-support
  *
  * @deprecated use the WebSocketUpgrade attribute instead since 10.2.0
  */

akka-http-core/src/main/scala/akka/http/javadsl/model/ws/WebSocketUpgrade.scala

@@ -14,7 +14,7 @@ import akka.stream.{ FlowShape, Graph, SinkShape, SourceShape }
  * create a WebSocket handshake response and handle the WebSocket message stream with the given handler.
  *
  * This is a low-level API. You might want to use `handleWebSocketMessages` instead as documented
- * at https://doc.akka.io/docs/akka-http/current/server-side/websocket-support.html#routing-support
+ * at https://doc.akka.io/libraries/akka-http/current/server-side/websocket-support.html#routing-support
  */
 trait WebSocketUpgrade {
   /**

akka-http-core/src/main/scala/akka/http/scaladsl/model/ws/WebSocketUpgrade.scala

@@ -18,7 +18,7 @@ import akka.http.scaladsl.model.HttpResponse
  * registers a WebSocket handler.
  *
  * This is a low-level API. You might want to use `handleWebSocketMessages` instead as documented
- * at https://doc.akka.io/docs/akka-http/current/server-side/websocket-support.html#routing-support
+ * at https://doc.akka.io/libraries/akka-http/current/server-side/websocket-support.html#routing-support
  */
 trait WebSocketUpgrade extends jm.ws.WebSocketUpgrade {
   /**

build.sbt

@@ -485,12 +485,12 @@ lazy val docs = project("docs")
       "quickstart-scala/index.html"),
     Compile / paradoxProperties ++= Map(
       "project.name" -> "Akka HTTP",
-      "canonical.base_url" -> "https://doc.akka.io/docs/akka-http/current",
+      "canonical.base_url" -> "https://doc.akka.io/libraries/akka-http/current",
       "akka.version" -> AkkaDependency.docs.version,
       "akka.minimum.version" -> AkkaDependency.minimumExpectedAkkaVersion,
       "jackson.xml.version" -> Dependencies.jacksonXmlVersion,
       "scalafix.version" -> _root_.scalafix.sbt.BuildInfo.scalafixVersion, // grab from scalafix plugin directly
-      "extref.akka-docs.base_url" -> s"https://doc.akka.io/docs/akka/${AkkaDependency.docs.link}/%s",
+      "extref.akka-docs.base_url" -> s"https://doc.akka.io/libraries/akka-core/${AkkaDependency.docs.link}/%s",
       "javadoc.akka.http.base_url" -> {
         val v = if (isSnapshot.value) "current" else version.value
         s"https://doc.akka.io/japi/akka-http/$v"

docs/release-train-issue-template.md

@@ -72,7 +72,7 @@ For minor or major releases:
 ### Afterwards
 
 - [ ] Add the released version to `project/MiMa.scala` to the `mimaPreviousArtifacts` key *of all current compatible branches*.
-- [ ] Update [akka-dependencies bom](https://github.com/lightbend/akka-dependencies) and version for [Akka module versions](https://doc.akka.io/docs/akka-dependencies/current/) in [akka-dependencies repo](https://github.com/akka/akka-dependencies)
+- [ ] Update [akka-dependencies bom](https://github.com/lightbend/akka-dependencies) and version for [Akka module versions](https://doc.akka.io/libraries/akka-dependencies/current/) in [akka-dependencies repo](https://github.com/akka/akka-dependencies)
 - [ ] Update [Akka Guide samples](https://github.com/akka/akka-platform-guide)
 - [ ] Update sbt new (g8) template:
   - [ ] [Akka HTTP Scala](https://github.com/akka/akka-http-quickstart-scala.g8/blob/main/src/main/g8/default.properties)

docs/src/main/paradox/client-side/client-transport.md

@@ -109,7 +109,7 @@ Java
 You can use @apidoc[ClientTransport.withCustomResolver](ClientTransport) to customize host name resolution. The given resolution function will be called for every connection attempt to resolve
 a hostname / port combination (potentially asynchronously) to an `InetSocketAddress`.
 
-As a backend to implement the resolution function you can use Akka's [Async DNS Resolution](https://doc.akka.io/docs/akka/current/io-dns.html#dns-extension).
+As a backend to implement the resolution function you can use Akka's [Async DNS Resolution](https://doc.akka.io/libraries/akka-core/current/io-dns.html#dns-extension).
 
 Potential use cases:
 

docs/src/main/paradox/routing-dsl/directives/route-directives/handle.md

@@ -14,7 +14,7 @@ Creates a @scala[@scaladoc[Route](akka.http.scaladsl.server.index#Route=akka.htt
 that handles the request using a function or `PartialFunction` from @apidoc[HttpRequest] to a @scala[`Future`]@java[`CompletionStage`] of @apidoc[HttpResponse].
 
 This directive can be used to include external components request processing components defined as a `Function` or `PartialFunction`
-(like [those provided by akka-grpc](https://doc.akka.io/docs/akka-grpc/current/server/walkthrough.html#serving-multiple-services))
+(like [those provided by akka-grpc](https://doc.akka.io/libraries/akka-grpc/current/server/walkthrough.html#serving-multiple-services))
 into a routing tree defined by directives and routes.
 
 For the `PartialFunction` variant, the given list of rejections will be used to reject the request with if the `PartialFunction` is not defined for a request. By default,
@@ -25,4 +25,4 @@ There is also a strict version called @ref[handleSync](handleSync.md).
 ## Example
 
 Scala
-:  @@snip [RouteDirectivesExamplesSpec.scala](/docs/src/test/scala/docs/http/scaladsl/server/directives/RouteDirectivesExamplesSpec.scala) { #handle-examples-with-PF }
+:  @@snip [RouteDirectivesExamplesSpec.scala](/docs/src/test/scala/docs/http/scaladsl/server/directives/RouteDirectivesExamplesSpec.scala) { #handle-examples-with-PF }

project/AkkaDependency.scala

@@ -39,7 +39,7 @@ object AkkaDependency {
     }
   }
 
-  // Default version updated only when needed, https://doc.akka.io//docs/akka/current/project/downstream-upgrade-strategy.html
+  // Default version updated only when needed, https://doc.akka.io/libraries/akka-core/current/project/downstream-upgrade-strategy.html
   val minimumExpectedAkkaVersion = "2.9.3"
   val default = akkaDependency(defaultVersion = minimumExpectedAkkaVersion)
   val docs = akkaDependency(defaultVersion = minimumExpectedAkkaVersion)
@@ -87,7 +87,7 @@ object AkkaDependency {
     import scala.concurrent.Await
     import scala.concurrent.duration._
 
-    val versionFile = "https://doc.akka.io/docs/akka/snapshot/paradox.json"
+    val versionFile = "https://doc.akka.io/libraries/akka-core/snapshot/paradox.json"
     val body = Await.result(http.run(url(versionFile)), 10.seconds).bodyAsString
     val versionProperty = """"version" : """"
     val i = body.indexOf(versionProperty)

samples/akka-http-quickstart-scala/src/main/resources/logback.xml

@@ -1,6 +1,6 @@
 <configuration>
     <!-- This is a development logging configuration that logs to standard out, for an example of a production
-        logging config, see the Akka docs: https://doc.akka.io/docs/akka/current/typed/logging.html#logback -->
+        logging config, see the Akka docs: https://doc.akka.io/libraries/akka-core/current/typed/logging.html#logback -->
     <appender name="STDOUT" target="System.out" class="ch.qos.logback.core.ConsoleAppender">
         <encoder>
             <pattern>[%date{ISO8601}] [%level] [%logger] [%thread] [%X{akkaSource}] - %msg%n</pattern>