From c44bdb1e587672580e48499c1569cadc8d0225d8 Mon Sep 17 00:00:00 2001
From: Jay Palacio <jpalacio@dropbox.com>
Date: Fri, 26 Jun 2026 11:56:25 -0400
Subject: [PATCH 1/2] Fix Javadoc generation on JDK 21

---
 core/build.gradle                                   | 7 ++++---
 core/src/main/java/com/dropbox/core/DbxWebAuth.java | 8 ++++----
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/core/build.gradle b/core/build.gradle
index 06cf5e7a5..165386c43 100644
--- a/core/build.gradle
+++ b/core/build.gradle
@@ -207,13 +207,14 @@ tasks.named("javadoc", Javadoc) {
     title = "${project.mavenName} ${versionName} API"
     failOnError = true
 
-    // JDK 8's javadoc has an on-by-default lint called "missing", which requires that everything
-    // be documented. Disable this lint because we intentionally don't document some things.
+    // JDK's javadoc has on-by-default lints for missing docs and unresolved references. Disable
+    // these because we intentionally don't document some things and generated/cross-module links
+    // are not always resolvable in this standalone Javadoc task.
     //
     // NOTE: ugly hack to set our doclint settings due to strange handling of string options by the
     // javadoc task.
     if (JavaVersion.current().isJava8Compatible()) {
-        options.addBooleanOption "Xdoclint:all,-missing", true
+        options.addBooleanOption "Xdoclint:all,-missing,-reference", true
     }
     options.addStringOption "link", "http://docs.oracle.com/javase/8/docs/api/"
 }
diff --git a/core/src/main/java/com/dropbox/core/DbxWebAuth.java b/core/src/main/java/com/dropbox/core/DbxWebAuth.java
index 4baef1f07..e9dc22da2 100644
--- a/core/src/main/java/com/dropbox/core/DbxWebAuth.java
+++ b/core/src/main/java/com/dropbox/core/DbxWebAuth.java
@@ -24,7 +24,7 @@
  * for a user when they first use your application.  Once you have an access token for that user, it
  * remains valid for years.
  *
- * <h1> Redirect example </h1>
+ * <h2> Redirect example </h2>
  * <p> One-time setup typically done on server initialization: </p>
  * <pre>
  *     {@link DbxRequestConfig} requestConfig = new DbxRequestConfig("text-edit/0.1");
@@ -34,7 +34,7 @@
  *     String redirectUri = "http://my-server.com/dropbox-auth-finish";
  * </pre>
  *
- * <h2> Part 1 </h2>
+ * <h3> Part 1 </h3>
  * <p> Handler for "http://my-server.com/dropbox-auth-start": </p>
  * <pre>
  *     {@link jakarta.servlet.http.HttpServletRequest} request = ...
@@ -59,7 +59,7 @@
  *     response.sendRedirect(authorizePageUrl);
  * </pre>
  *
- * <h2> Part 2 </h2>
+ * <h3> Part 2 </h3>
  * <p> Handler for "http://my-server.com/dropbox-auth-finish": </p>
  * <pre>
  *     {@link jakarta.servlet.http.HttpServletRequest} request = ...
@@ -111,7 +111,7 @@
  *     ...
  * </pre>
  *
- * <h1> No Redirect Example </h1>
+ * <h2> No Redirect Example </h2>
  *
  * <pre>
  *     {@link DbxRequestConfig} requestConfig = new DbxRequestConfig("text-edit/0.1");

From b47752f707741934cc028677dfbce2877b4245dd Mon Sep 17 00:00:00 2001
From: Jay Palacio <jpalacio@dropbox.com>
Date: Fri, 26 Jun 2026 12:00:41 -0400
Subject: [PATCH 2/2] Run Javadocs in CI checks

---
 .github/workflows/check.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/check.yml b/.github/workflows/check.yml
index 9657d8ad9..5f30f41d0 100644
--- a/.github/workflows/check.yml
+++ b/.github/workflows/check.yml
@@ -54,6 +54,9 @@ jobs:
     - name: Check
       run: ./gradlew check
 
+    - name: Generate Javadocs
+      run: ./gradlew :core:javadoc :android:javaDocReleaseGeneration
+
   integration:
     runs-on: ubuntu-latest
     if: github.repository == 'dropbox/dropbox-sdk-java' && github.ref == 'refs/heads/main' && github.event_name != 'pull_request'