From 6aa94d1ec51220296a07135e081e3d534bba8194 Mon Sep 17 00:00:00 2001
From: James Seibel <jeseibel@gondtc.com>
Date: Mon, 26 Jun 2023 19:26:22 -0500
Subject: [PATCH] add build_api_docs to the CI

---
 .gitlab-ci.yml | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index fb054a1b9..1f46bc94a 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -9,6 +9,7 @@ stages:
   - build_1_18_2
   - build_1_19_4
   - build_1_20_1
+  - build_api_javadocs
 
 variables:
     # Pull core when building
@@ -120,6 +121,30 @@ build_1_20_1:
   allow_failure: true
 
 
+# generate API javadocs
+build_api_javadocs:
+  stage: build_api_javadocs
+  script:
+    # this should only run for the API
+    - ./gradlew api:clean --gradle-user-home cache/;
+    # this also runs unit tests
+    - ./gradlew api:build --gradle-user-home cache/;
+    - ./gradlew api:javadoc --gradle-user-home cache/;
+  image: eclipse-temurin:17
+  artifacts:
+    name: "ApiJavaDoc-${CI_COMMIT_SHORT_SHA}-${CI_COMMIT_TIMESTAMP}"
+    paths:
+      - $CI_PROJECT_DIR/coreSubProjects/api/build/docs/javadoc/
+    expose_as: "apiJavaDocs"
+    when: always
+  cache:
+    key: "gradleCache"
+    policy: pull-push
+    paths:
+      - .gradle
+      - cache/
+  allow_failure: false
+