docs: first cut of Antora docs site

Author: bsbodden

.github/workflows/docs.yml

@@ -0,0 +1,82 @@
+name: Deploy Docs
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+  repository_dispatch:
+    types: [build-docs]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build and Deploy Docs
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Java
+        uses: actions/setup-java@v4
+        with:
+          java-version: 21
+          distribution: 'zulu'
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Cache Gradle
+        uses: actions/cache@v4
+        with:
+          path: ~/.gradle/caches
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}-${{ hashFiles('**/gradle.properties') }}
+          restore-keys: |
+            ${{ runner.os }}-gradle-
+
+      - name: Cache Gradle wrapper
+        uses: actions/cache@v4
+        with:
+          path: ~/.gradle/wrapper
+          key: ${{ runner.os }}-gradlew-${{ hashFiles('**/gradlew') }}
+          restore-keys: ${{ runner.os }}-gradlew-
+
+      - name: Set Release Version in Docs
+        run: |
+          VERSION=$(cat gradle.properties | grep "version" | cut -d'=' -f2 | tr -d ' ')
+          echo "Setting documentation version to $VERSION"
+          sed -i "s/display_version: '.*'/display_version: '$VERSION'/" docs/content/antora.yml
+          sed -i "s/redisvl-version: '.*'/redisvl-version: '$VERSION'/" docs/content/antora.yml
+
+      - name: Build Documentation
+        run: |
+          ./gradlew :docs:build
+
+      - name: Add .nojekyll file
+        run: touch docs/build/site/.nojekyll
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'docs/build/site'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

build.gradle.kts

@@ -147,4 +147,47 @@ tasks.register<Copy>("copyJarToNotebooks") {
 // Make build depend on copying jar
 tasks.named("build") {
     dependsOn("copyJarToNotebooks")
+}
+
+// Add aggregated Javadoc generation
+tasks.register<Javadoc>("aggregateJavadoc") {
+    description = "Generate aggregated Javadoc for all modules"
+    group = "documentation"
+
+    val coreProject = project(":core")
+    source(coreProject.the<SourceSetContainer>()["main"].allJava)
+    classpath = files(coreProject.the<SourceSetContainer>()["main"].compileClasspath)
+    setDestinationDir(layout.buildDirectory.dir("docs/javadoc/aggregate").get().asFile)
+
+    (options as StandardJavadocDocletOptions).apply {
+        title = "RedisVL ${project.version} API"
+        windowTitle = "RedisVL ${project.version}"
+        author(true)
+        version(true)
+        use(true)
+        splitIndex(true)
+        links(
+            "https://docs.oracle.com/en/java/javase/17/docs/api/",
+            "https://www.javadoc.io/doc/redis.clients/jedis/latest/"
+        )
+    }
+
+    // Ensure Javadoc generation succeeds
+    isFailOnError = false
+}
+
+// Individual module Javadocs
+tasks.register("generateModuleJavadocs") {
+    description = "Generate Javadoc for individual modules"
+    group = "documentation"
+
+    val coreProject = project(":core")
+    dependsOn(coreProject.tasks.named("javadoc"))
+
+    doLast {
+        copy {
+            from(coreProject.tasks.named<Javadoc>("javadoc").get().destinationDir)
+            into(layout.buildDirectory.dir("docs/javadoc/modules/core").get().asFile)
+        }
+    }
 }