enforce javadoc warnings as build failures

.github/workflows/ci.yml

@@ -10,6 +10,13 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  # Opt in to Node 24 ahead of GitHub's 2026-06-02 forced upgrade. Both
+  # actions/checkout@v4 and actions/setup-java@v4 are already the latest
+  # major versions and ship Node 20 binaries; this env var lets the runner
+  # execute them under Node 24 today.
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
 jobs:
   test:
     runs-on: ubuntu-latest
@@ -25,3 +32,18 @@ jobs:
 
       - name: Run tests
         run: ./mvnw -B test
+
+  javadoc:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up JDK 11
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: 11
+          cache: maven
+
+      - name: Verify Javadoc
+        run: ./mvnw -B javadoc:jar

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>com.accessgrid</groupId>
     <artifactId>access-grid-sdk</artifactId>
-    <version>1.4.0</version>
+    <version>1.4.1</version>
 
     <name>Access Grid SDK</name>
     <description>Java SDK for Access Grid API</description>
@@ -174,6 +174,9 @@
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-javadoc-plugin</artifactId>
                 <version>3.4.1</version>
+                <configuration>
+                    <failOnWarnings>true</failOnWarnings>
+                </configuration>
                 <executions>
                     <execution>
                         <id>attach-javadocs</id>