From 306db071d4c1ed797ca7e1bb7b06a0e62003e7b2 Mon Sep 17 00:00:00 2001
From: Eric Deandrea <eric.deandrea@ibm.com>
Date: Mon, 8 Dec 2025 15:50:59 -0500
Subject: [PATCH] ci: Refactor docs workflow env setup and version handling

Signed-off-by: Eric Deandrea <eric.deandrea@ibm.com>
---
 .github/project.yml        |  1 +
 .github/workflows/docs.yml | 23 +++++++++++++++--------
 2 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/.github/project.yml b/.github/project.yml
index 5ee1fc5..3b65c3c 100644
--- a/.github/project.yml
+++ b/.github/project.yml
@@ -1,3 +1,4 @@
 release:
+  previous-version: 0.2.0
   current-version: 0.2.1
   next-version: 0.2.2
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 4bcd346..2b105f2 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -31,14 +31,6 @@ jobs:
     name: Build/publish Docs
     if: github.repository == 'docling-project/docling-java'
     steps:
-      - name: Setup env (release)
-        if: github.event_name == 'release'
-        run: echo "DOCS_ALIAS=current" >> $GITHUB_ENV
-
-      - name: Setup env (other)
-        if: (github.event_name != 'release')
-        run: echo "DOCS_ALIAS=dev" >> $GITHUB_ENV
-
       - name: Checkout sources
         if: github.event_name != 'release'
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
@@ -54,6 +46,20 @@ jobs:
           ref: ${{ github.event.release.tag_name }}
           path: app
 
+      - name: Setup env (release)
+        if: github.event_name == 'release'
+        working-directory: app
+        run: |
+          echo "DOCS_ALIAS=current" >> $GITHUB_ENV
+          echo "DOCS_VERSION=$(yq '.release.previous-version' .github/project.yml)" >> $GITHUB_ENV
+
+      - name: Setup env (other)
+        if: (github.event_name != 'release')
+        working-directory: app
+        run: |
+          echo "DOCS_ALIAS=dev" >> $GITHUB_ENV
+          echo "CURRENT_VERSION=$(yq '.release.current-version' after/.github/project.yml)" >> $GITHUB_ENV
+
       - name: Get docs
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
         with:
@@ -83,6 +89,7 @@ jobs:
         working-directory: app
         run: |
           ./gradlew --console=plain :docs:build \
+            -Pversion=${{ env.DOCS_VERSION }} \
             -Pdocs.alias=${{ env.DOCS_ALIAS }} \
             -Pdocs.versionsFile=${{ github.workspace }}/docs/versions.json