From 115a96f247c1ae96af86121e7943191c01ecc311 Mon Sep 17 00:00:00 2001
From: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
Date: Mon, 26 Jan 2026 10:01:44 +0100
Subject: [PATCH] feat: add Javadoc build step and configure skipping in
 pom.xml

Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
---
 .github/workflows/test-release-build.yml | 2 ++
 benchmarks/pom.xml                       | 1 +
 examples/pom.xml                         | 1 +
 integration-tests/pom.xml                | 1 +
 pom.xml                                  | 7 +++++++
 5 files changed, 12 insertions(+)

diff --git a/.github/workflows/test-release-build.yml b/.github/workflows/test-release-build.yml
index 89e414540..923b488c3 100644
--- a/.github/workflows/test-release-build.yml
+++ b/.github/workflows/test-release-build.yml
@@ -27,6 +27,8 @@ jobs:
           key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
           restore-keys: |
             ${{ runner.os }}-maven-
+      - name: Build Javadoc
+        run: mise run javadoc
       - name: Build release version
         run: mise run build-release
         env:
diff --git a/benchmarks/pom.xml b/benchmarks/pom.xml
index b484e4754..96a6c740a 100644
--- a/benchmarks/pom.xml
+++ b/benchmarks/pom.xml
@@ -23,6 +23,7 @@
     <simpleclient.version>0.16.0</simpleclient.version>
     <codahale.version>3.0.2</codahale.version>
     <coverage.skip>true</coverage.skip>
+    <javadoc.skip>true</javadoc.skip>
   </properties>
 
   <dependencyManagement>
diff --git a/examples/pom.xml b/examples/pom.xml
index f88b313a2..5b93c068f 100644
--- a/examples/pom.xml
+++ b/examples/pom.xml
@@ -19,6 +19,7 @@
 
   <properties>
     <coverage.skip>true</coverage.skip>
+    <javadoc.skip>true</javadoc.skip>
   </properties>
 
   <modules>
diff --git a/integration-tests/pom.xml b/integration-tests/pom.xml
index b932c5799..49880c484 100644
--- a/integration-tests/pom.xml
+++ b/integration-tests/pom.xml
@@ -19,6 +19,7 @@
 
   <properties>
     <coverage.skip>true</coverage.skip>
+    <javadoc.skip>true</javadoc.skip>
   </properties>
 
   <modules>
diff --git a/pom.xml b/pom.xml
index 8e121f2a3..3f3aa9b4a 100644
--- a/pom.xml
+++ b/pom.xml
@@ -334,6 +334,12 @@
           <rulesUri>file://${project.basedir}/version-rules.xml</rulesUri>
         </configuration>
       </plugin>
+      <plugin>
+        <artifactId>maven-javadoc-plugin</artifactId>
+        <configuration>
+          <skip>${javadoc.skip}</skip>
+        </configuration>
+      </plugin>
     </plugins>
   </build>
 
@@ -409,6 +415,7 @@
           <plugin>
             <artifactId>maven-javadoc-plugin</artifactId>
             <configuration>
+              <skip>${javadoc.skip}</skip>
               <encoding>UTF-8</encoding>
               <docencoding>UTF-8</docencoding>
               <linksource>true</linksource>