fix: fix broken javadoc by switching to dokka.

MarkDaoust · copybara-github · commit 4b76baf1c1f6 · 2026-04-13T20:00:08.000-07:00
PiperOrigin-RevId: 899311400
diff --git a/.github/workflows/publish-javadoc.yml b/.github/workflows/publish-javadoc.yml
@@ -20,4 +20,4 @@ jobs:
           java-version: 17
           target-folder: javadoc
           project: maven
-          custom-command: mvn javadoc:javadoc
+          custom-command: mvn dokka:javadoc
diff --git a/pom.xml b/pom.xml
@@ -294,20 +294,7 @@
             </execution>
           </executions>
         </plugin>
-        <plugin>
-          <groupId>org.apache.maven.plugins</groupId>
-          <artifactId>maven-javadoc-plugin</artifactId>
-          <version>3.6.3</version>
-          <configuration>
-            <show>public</show>
-            <doclint>html</doclint>
-            <nohelp>true</nohelp>
-            <outputDirectory>${project.build.directory}/javadoc</outputDirectory>
-            <doctitle>Google Gen AI Java SDK</doctitle>
-            <source>${maven.compiler.source}</source>
-            <encoding>UTF-8</encoding>
-          </configuration>
-        </plugin>
+
         <plugin>
           <groupId>org.sonatype.plugins</groupId>
           <artifactId>nexus-staging-maven-plugin</artifactId>
@@ -386,6 +373,36 @@
           </execution>
         </executions>
       </plugin>
+      <plugin>
+        <groupId>org.jetbrains.dokka</groupId>
+        <artifactId>dokka-maven-plugin</artifactId>
+        <version>2.0.0</version>
+        <executions>
+          <execution>
+            <phase>prepare-package</phase>
+            <goals>
+              <goal>javadoc</goal>
+              <goal>javadocJar</goal>
+            </goals>
+          </execution>
+        </executions>
+        <configuration>
+          <outputDir>${project.build.directory}/site/apidocs</outputDir>
+          <perPackageOptions>
+            <packageOption>
+              <matchingRegex>com\.google\.genai\.interactions.*</matchingRegex>
+              <suppress>true</suppress>
+            </packageOption>
+          </perPackageOptions>
+          <dokkaPlugins>
+            <plugin>
+              <groupId>org.jetbrains.dokka</groupId>
+              <artifactId>kotlin-as-java-plugin</artifactId>
+              <version>2.0.0</version>
+            </plugin>
+          </dokkaPlugins>
+        </configuration>
+      </plugin>
       <plugin>
         <groupId>org.jacoco</groupId>
         <artifactId>jacoco-maven-plugin</artifactId>
