From 2f54ac23b942d66a7d4a09c406501414f6b9bf39 Mon Sep 17 00:00:00 2001 From: PJ Fanning Date: Fri, 9 Oct 2026 10:27:07 +0100 Subject: [PATCH 1/4] ci: pin site-link-validator to 0.2.5 Motivation: The Link Validator workflow has failed at the cs launch step since #3457 because site-link-validator 0.3.0 was never published to Maven Central (its release job failed with a Sonatype 401). Modification: Use 0.2.5, the latest published version, and drop the $GITHUB_STEP_SUMMARY argument that 0.2.5 does not support. Result: The link validator runs again. Tests: - Link Validator workflow run on the PR References: Refs #3457 --- .github/workflows/link-validator.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/link-validator.yml b/.github/workflows/link-validator.yml index 5a9dd5a784..4ece61674c 100644 --- a/.github/workflows/link-validator.yml +++ b/.github/workflows/link-validator.yml @@ -54,4 +54,4 @@ jobs: sbt -Dpekko.genjavadoc.enabled=true "Javaunidoc/doc; Compile/unidoc; docs/paradox" - name: Run Link Validator - run: cs launch net.runne::site-link-validator:0.3.0 -- scripts/link-validator.conf $GITHUB_STEP_SUMMARY + run: cs launch net.runne::site-link-validator:0.2.5 -- scripts/link-validator.conf From 1b137c9579b0612d824f25178ad8493182ae1475 Mon Sep 17 00:00:00 2001 From: PJ Fanning Date: Fri, 9 Oct 2026 10:27:08 +0100 Subject: [PATCH 2/4] docs: fix broken links reported by the link validator Motivation: The link validator reports 404s for moved pages and 403s from sites that block automated clients. Modification: - Point Maven Central search links at Sonatype Central - Link the logback AsyncAppender manual section (apidocs were removed) - Point the pekko-management extref at the 2.0 docs, since the rolling-updates page is not in the current docs - Update the moved Datadog stolen-CPU article URL - Ignore sites that return 403 to bots (bugs.openjdk.org, medium, stackoverflow, waldo.scholars.harvard.edu) and the unpublished scala.runtime Scaladoc Result: The link validator reports no failure responses. Tests: - Link Validator workflow run on the PR References: None - link validator maintenance --- .../pekko/cluster/metrics/MetricsCollector.scala | 2 +- docs/src/main/paradox/cluster-metrics.md | 2 +- docs/src/main/paradox/project/links.md | 2 +- docs/src/main/paradox/remoting-artery.md | 2 +- docs/src/main/paradox/typed/logging.md | 2 +- project/Paradox.scala | 2 +- scripts/link-validator.conf | 11 +++++++---- 7 files changed, 13 insertions(+), 10 deletions(-) diff --git a/cluster-metrics/src/main/scala/org/apache/pekko/cluster/metrics/MetricsCollector.scala b/cluster-metrics/src/main/scala/org/apache/pekko/cluster/metrics/MetricsCollector.scala index 64005d2db6..aceb590ad3 100644 --- a/cluster-metrics/src/main/scala/org/apache/pekko/cluster/metrics/MetricsCollector.scala +++ b/cluster-metrics/src/main/scala/org/apache/pekko/cluster/metrics/MetricsCollector.scala @@ -248,7 +248,7 @@ class SigarMetricsCollector(address: Address, decayFactor: Double, sigar: SigarP /** * (SIGAR) Returns the stolen CPU time. Relevant to virtual hosting environments. * For details please see: Wikipedia - CPU time subdivision and - * Understanding AWS stolen CPU and how it affects your apps + * Understanding AWS stolen CPU and how it affects your apps * * Creates a new instance each time. */ diff --git a/docs/src/main/paradox/cluster-metrics.md b/docs/src/main/paradox/cluster-metrics.md index a04937f59c..2644088a06 100644 --- a/docs/src/main/paradox/cluster-metrics.md +++ b/docs/src/main/paradox/cluster-metrics.md @@ -114,7 +114,7 @@ To enable usage of Sigar you can add the following dependency to the user projec version="$sigar_loader.version$" } -You can download Kamon sigar-loader from [Maven Central](https://search.maven.org/search?q=sigar-loader) +You can download Kamon sigar-loader from [Sonatype Central](https://central.sonatype.com/artifact/io.kamon/sigar-loader) ## Adaptive Load Balancing diff --git a/docs/src/main/paradox/project/links.md b/docs/src/main/paradox/project/links.md index 090c570b58..f1e36a8733 100644 --- a/docs/src/main/paradox/project/links.md +++ b/docs/src/main/paradox/project/links.md @@ -7,7 +7,7 @@ Pekko uses Git and is hosted at [Github apache/pekko](https://github.com/apache/ ## Releases Repository All Pekko releases are published via Sonatype to Maven Central, see -[search.maven.org](https://search.maven.org/search?q=g:org.apache.pekko) +[Sonatype Central](https://central.sonatype.com/namespace/org.apache.pekko) ## Snapshots Repository diff --git a/docs/src/main/paradox/remoting-artery.md b/docs/src/main/paradox/remoting-artery.md index 3a0ea08813..5608df063f 100644 --- a/docs/src/main/paradox/remoting-artery.md +++ b/docs/src/main/paradox/remoting-artery.md @@ -601,7 +601,7 @@ The classpath would be approximately (but you will need to fix up the version nu agrona-2.6.0.jar:aeron-driver-1.53.1.jar:aeron-client-1.53.1.jar ``` -You find those jar files on [Maven Central](https://search.maven.org/), or you can create a +You find those jar files on [Sonatype Central](https://central.sonatype.com/), or you can create a package with your preferred build tool. You can pass [Aeron properties](https://github.com/real-logic/Aeron/wiki/Configuration-Options) as diff --git a/docs/src/main/paradox/typed/logging.md b/docs/src/main/paradox/typed/logging.md index b1466f037a..1bb6c36030 100644 --- a/docs/src/main/paradox/typed/logging.md +++ b/docs/src/main/paradox/typed/logging.md @@ -199,7 +199,7 @@ A starting point for configuration of `logback.xml` for production: @@snip [logback.xml](/actor-typed-tests/src/test/resources/logback-doc-prod.xml) -Note that the [AsyncAppender](https://logback.qos.ch/apidocs/ch.qos.logback.classic/ch/qos/logback/classic/AsyncAppender.html) may drop log events if the queue becomes full, which may happen if the +Note that the [AsyncAppender](https://logback.qos.ch/manual/appenders.html#AsyncAppender) may drop log events if the queue becomes full, which may happen if the logging backend can't keep up with the throughput of produced log events. Dropping log events is necessary if you want to gracefully degrade your application if only your logging backend or filesystem is experiencing issues. diff --git a/project/Paradox.scala b/project/Paradox.scala index dabca980a9..ddf16efc0d 100644 --- a/project/Paradox.scala +++ b/project/Paradox.scala @@ -33,7 +33,7 @@ object Paradox { GitHub .url(version.value), // for links like this: @github[#1](#1) or @github[83986f9](83986f9) "extref.pekko.http.base_url" -> s"$pekkoBaseURL/docs/pekko-http/current/%s", - "extref.pekko-management.base_url" -> s"$pekkoBaseURL/docs/pekko-management/current/%s", + "extref.pekko-management.base_url" -> s"$pekkoBaseURL/docs/pekko-management/2.0/%s", "extref.pekko-management-snapshot.base_url" -> s"$pekkoBaseURL/docs/pekko-management/snapshot/%s", "extref.platform-guide.base_url" -> "https://developer.lightbend.com/docs/akka-platform-guide/%s", "extref.wikipedia.base_url" -> "https://en.wikipedia.org/wiki/%s", diff --git a/scripts/link-validator.conf b/scripts/link-validator.conf index 2c990f0f47..013e5537a8 100644 --- a/scripts/link-validator.conf +++ b/scripts/link-validator.conf @@ -51,10 +51,13 @@ site-link-validator { ignore-prefixes = [ ## GitHub will block with "429 Too Many Requests" "https://github.com/" - "https://www.scala-lang.org/api/2.13.18/scala/runtime/AbstractFunction1.html" - "https://www.scala-lang.org/api/2.13.18/scala/runtime/AbstractFunction2.html" - "https://www.scala-lang.org/api/2.13.18/scala/runtime/AbstractFunction3.html" - "https://www.scala-lang.org/api/2.13.18/scala/runtime/AbstractPartialFunction.html" + ## These sites block automated clients with "403 Forbidden" + "https://bugs.openjdk.org/" + "https://cowtowncoder.medium.com/" + "https://stackoverflow.com/" + "https://waldo.scholars.harvard.edu/" + ## scala.runtime is not part of the published Scaladoc + "https://www.scala-lang.org/api/2.13.18/scala/runtime/" ## Bug, see https://github.com/scala/bug/issues/12807 and https://github.com/lampepfl/dotty/issues/17973 "https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/nio/file/StandardOpenOption$.html" ] From 796622ea33b0b613387d8ada341d23864f3bf4c7 Mon Sep 17 00:00:00 2001 From: PJ Fanning Date: Fri, 9 Oct 2026 10:27:08 +0100 Subject: [PATCH 3/4] TEMP: run link validator on pull requests (revert before merge) --- .github/workflows/link-validator.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/link-validator.yml b/.github/workflows/link-validator.yml index 4ece61674c..0ddb83a1e2 100644 --- a/.github/workflows/link-validator.yml +++ b/.github/workflows/link-validator.yml @@ -12,6 +12,7 @@ permissions: {} on: workflow_dispatch: + pull_request: # TEMP: remove before merging schedule: - cron: '0 6 * * 1' From 1337c7f9a90ad3c9ae292b782eee88040f253b77 Mon Sep 17 00:00:00 2001 From: PJ Fanning Date: Fri, 9 Oct 2026 11:26:28 +0100 Subject: [PATCH 4/4] Remove pull_request trigger from workflow Removed pull_request trigger from link-validator workflow. --- .github/workflows/link-validator.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/.github/workflows/link-validator.yml b/.github/workflows/link-validator.yml index 0ddb83a1e2..4ece61674c 100644 --- a/.github/workflows/link-validator.yml +++ b/.github/workflows/link-validator.yml @@ -12,7 +12,6 @@ permissions: {} on: workflow_dispatch: - pull_request: # TEMP: remove before merging schedule: - cron: '0 6 * * 1'