ci: Update docs workflow to include existing pages artifact and adjust dependencies (#84)

Signed-off-by: Eric Deandrea <[email protected]>

Author: edeandrea

.github/workflows/docs.yml

@@ -45,8 +45,14 @@ jobs:
           distribution: temurin
           cache: gradle
 
+      - name: Download existing pages
+        uses: actions/download-artifact@v5
+        with:
+          name: github-pages
+          path: docs/build/mkdocs
+
       - name: Generate documentation
-        run: ./gradlew --console=plain clean :docs:build
+        run: ./gradlew --console=plain :docs:build
 
       - name: Setup pages
         uses: actions/configure-pages@v5

docs/build.gradle.kts

@@ -35,11 +35,12 @@ mkdocs {
     org.codehaus.groovy.runtime.InvokerHelper.setProperty(this, "versionAliases", arrayOf("dev"))
     rootRedirectTo = "dev"
     generateVersionsFile = true
+    existingVersionsFile = layout.buildDirectory.dir("mkdocs").get().file("versions.json").asFile.absolutePath
   }
 }
 
 tasks.register("build") {
-  dependsOn(tasks.named("mkdocsVersionsFile"))
+  dependsOn(tasks.named("mkdocsBuild"))
 }
 
 tasks.register("clean") {