Enable markdown docs

.github/workflows/ci.yml

@@ -2,6 +2,7 @@ name: CI
 
 on:
   pull_request: {}
+  workflow_dispatch: {}
 
 jobs:
   build:
@@ -11,12 +12,25 @@ jobs:
       - name: Checkout source code
         uses: actions/checkout@v4
 
+      - name: Set up JDK 25 for Javadoc toolchain
+        uses: actions/setup-java@v4
+        with:
+          java-version: '25'
+          distribution: 'temurin'
+
       - name: Set up JDK 17
         uses: actions/setup-java@v4
         with:
           java-version: '17'
           distribution: 'temurin'
           cache: 'maven'
 
-      - name: Build
+      - name: Build and test
+        env:
+          JAVA_HOME: ${{ env.JAVA_HOME_17_X64 }}
         run: mvn verify
+
+      - name: Validate Javadoc generation
+        env:
+          JAVA_HOME: ${{ env.JAVA_HOME_17_X64 }}
+        run: mvn -Pjavadoc,javadoc-toolchain javadoc:aggregate

.github/workflows/maven-central-release.yml

@@ -8,8 +8,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-
-      - name: Set up Java
+
+      - name: Set up JDK 25 for Javadoc toolchain
+        uses: actions/setup-java@v4
+        with:
+          java-version: '25'
+          distribution: 'temurin'
+
+      - name: Set up JDK 17
         uses: actions/setup-java@v4
         with:
           java-version: '17'
@@ -25,17 +31,20 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: '20'
-          
+
       - name: Build and Test
+        env:
+          JAVA_HOME: ${{ env.JAVA_HOME_17_X64 }}
         run: mvn clean verify
 
       - name: Publish to Maven Central
-        run: |
-          mvn --batch-mode \
-            -Prelease \
-            -Pjavadoc \
-            deploy
         env:
           MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
           MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
           MAVEN_GPG_PASSPHRASE: ${{ secrets.SIGNING_PASSPHRASE }}
+          JAVA_HOME: ${{ env.JAVA_HOME_17_X64 }}
+        run: |
+          mvn --batch-mode \
+            -Prelease \
+            -Pjavadoc,javadoc-toolchain \
+            deploy

.github/workflows/publish-snapshot.yml

@@ -12,6 +12,12 @@ jobs:
       - name: Checkout source code
         uses: actions/checkout@v4
 
+      - name: Set up JDK 25 for Javadoc toolchain
+        uses: actions/setup-java@v4
+        with:
+          java-version: '25'
+          distribution: 'temurin'
+
       - name: Set up JDK 17
         uses: actions/setup-java@v4
         with:
@@ -29,16 +35,14 @@ jobs:
         with:
           node-version: '20'
 
-      - name: Generate Java docs
-        run: mvn -Pjavadoc -B javadoc:aggregate
-
       - name: Build with Maven and deploy to Sonatype snapshot repository
         env:
           MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
           MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
           MAVEN_GPG_PASSPHRASE: ${{ secrets.SIGNING_PASSPHRASE }}
+          JAVA_HOME: ${{ env.JAVA_HOME_17_X64 }}
         run: |
-          mvn -Pjavadoc -Prelease --batch-mode --update-snapshots deploy
+          mvn -Pjavadoc,javadoc-toolchain -Prelease --batch-mode --update-snapshots deploy
 
       - name: Capture project version
         run: echo PROJECT_VERSION=$(mvn help:evaluate -Dexpression=project.version --quiet -DforceStdout) >> $GITHUB_ENV