diff --git a/.github/workflows/java-integration-tests.yml b/.github/workflows/java-integration-tests.yml
index 8a23ae1..19abbc7 100644
--- a/.github/workflows/java-integration-tests.yml
+++ b/.github/workflows/java-integration-tests.yml
@@ -50,6 +50,13 @@ jobs:
- name: Static analysis (SpotBugs)
run: mvn -B -DskipTests compile spotbugs:check
+ # Build the javadoc (and source) jars with the same release-profile configuration the publish
+ # workflow uses, so doclint errors — broken {@link} references, unknown tags, malformed
+ # HTML — fail the PR here instead of surfacing for the first time mid-release. Signing is
+ # skipped: only the docs build is under test, no GPG key is available or needed.
+ - name: Javadoc (release docs build)
+ run: mvn -B -Prelease -DskipTests -Dgpg.skip=true package
+
# Offline unit tests (mock HTTP backend): prove the retry/error/signature/pagination logic
# without the API. Selected by pattern — every hermetic test in the base package runs, and the
# token-gated integration/example/doc-snippet suites are excluded — so new hermetic tests are
diff --git a/pom.xml b/pom.xml
index 7ba097d..27cdad5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -216,6 +216,27 @@
org.apache.maven.plugins
maven-javadoc-plugin
3.7.0
+
+
+
+
+ apiNote
+ a
+ API Note:
+
+
+ implSpec
+ a
+ Implementation Requirements:
+
+
+ implNote
+ a
+ Implementation Note:
+
+
+
attach-javadocs
diff --git a/src/main/java/com/apify/client/actor/ActorListOptions.java b/src/main/java/com/apify/client/actor/ActorListOptions.java
index 37fa112..3c10593 100644
--- a/src/main/java/com/apify/client/actor/ActorListOptions.java
+++ b/src/main/java/com/apify/client/actor/ActorListOptions.java
@@ -3,7 +3,7 @@
import com.apify.client.internal.ListOptionsLike;
import com.apify.client.internal.QueryParams;
-/** Options for {@link ActorCollectionClient#list(ActorListOptions)}. */
+/** Options for {@link ActorCollectionClient#list ActorCollectionClient.list(ActorListOptions)}. */
public final class ActorListOptions implements ListOptionsLike {
private Long offset;
private Long limit;