From d203541b7ba23acb27851243052d5e18702df8ec Mon Sep 17 00:00:00 2001
From: Austin Schuh <AustinSchuh@users.noreply.github.com>
Date: Tue, 5 Aug 2025 19:54:59 -0700
Subject: [PATCH] [bazel] Build wpilibj docs too (#8159)

We've got javadocs for each module, but wpilib has 1 for everything.
Build that too using rules_jvm_external.

Signed-off-by: Austin Schuh <austin.linux@gmail.com>
---
 BUILD.bazel      |  5 +++--
 docs/BUILD.bazel | 35 ++++++++++++++++++++++++++++++++++-
 2 files changed, 37 insertions(+), 3 deletions(-)

diff --git a/BUILD.bazel b/BUILD.bazel
index dbbe2ee94d..b44a1f8c09 100644
--- a/BUILD.bazel
+++ b/BUILD.bazel
@@ -69,13 +69,13 @@ publish_all(
         "//datalog:datalog-cpp_publish.publish",
         "//datalog:datalog-java_publish.publish",
         "//datalogtool:datalogtool_publish.publish",
+        "//docs:wpilibj_publish.publish",
         "//epilogue-processor:processor-java_publish.publish",
-        "//processstarter:processstarter_publish.publish",
         "//epilogue-runtime:epilogue-java_publish.publish",
         "//fieldImages:fieldImages-cpp_publish.publish",
         "//fieldImages:fieldImages-java_publish.publish",
-        "//glass:glassapp_publish.publish",
         "//glass:glass-cpp_publish.publish",
+        "//glass:glassapp_publish.publish",
         "//glass:glassnt-cpp_publish.publish",
         "//hal:hal-java_publish.publish",
         "//hal:wpiHal-cpp_publish.publish",
@@ -83,6 +83,7 @@ publish_all(
         "//ntcore:ntcore-java_publish.publish",
         "//ntcoreffi:ntcoreffi-cpp_publish.publish",
         "//outlineviewer:outlineviewer_publish.publish",
+        "//processstarter:processstarter_publish.publish",
         "//romiVendordep:romiVendordep-cpp_publish.publish",
         "//romiVendordep:romiVendordep-java_publish.publish",
         "//simulation/halsim_ds_socket:halsim_ds_socket-cpp_publish.publish",
diff --git a/docs/BUILD.bazel b/docs/BUILD.bazel
index f1eba0311e..3153b0234f 100644
--- a/docs/BUILD.bazel
+++ b/docs/BUILD.bazel
@@ -1,6 +1,6 @@
 load("@aspect_bazel_lib//lib:copy_file.bzl", "copy_file")
 load("@doxygen//:doxygen.bzl", "doxygen")
-load("@rules_jvm_external//:defs.bzl", "maven_export")
+load("@rules_jvm_external//:defs.bzl", "javadoc", "maven_export")
 load("@rules_pkg//:pkg.bzl", "pkg_zip")
 
 paths = [
@@ -100,3 +100,36 @@ maven_export(
     target = ":doxygen-zip",
     visibility = ["//visibility:public"],
 )
+
+javadoc(
+    name = "javadoc",
+    deps = [
+        "//apriltag:apriltag-java",
+        "//cameraserver:cameraserver-java",
+        "//cscore:cscore-java",
+        "//epilogue-runtime:epilogue-java",
+        "//hal:hal-java",
+        "//ntcore:ntcore-java",
+        "//romiVendordep:romiVendordep-java",
+        "//wpilibNewCommands:wpilibNewCommands-java",
+        "//wpilibj:wpilibj-java",
+        "//wpimath:wpimath-java",
+        "//wpinet:wpinet-java",
+        "//wpiunits:wpiunits-java",
+        "//wpiutil:wpiutil-java",
+        "//xrpVendordep:xrpVendordep-java",
+    ],
+)
+
+copy_file(
+    name = "javadoc-zip",
+    src = ":javadoc",
+    out = "javadoc-zip.zip",
+)
+
+maven_export(
+    name = "wpilibj_publish",
+    maven_coordinates = "edu.wpi.first.wpilibj:documentation:$(WPILIB_VERSION)",
+    target = ":javadoc-zip",
+    visibility = ["//visibility:public"],
+)