From f33ef69f3a383b987b907dae28c632f23b79c526 Mon Sep 17 00:00:00 2001
From: Kabir Khan <kkhan@redhat.com>
Date: Mon, 26 Oct 2026 22:48:47 +0100
Subject: [PATCH] fix(docs): parse default documentation version

---
 .github/scripts/create-latest-alias.sh      | 4 ++--
 .github/scripts/test-create-latest-alias.sh | 3 +++
 .github/workflows/check-site.yml            | 4 ++++
 .github/workflows/deploy-site.yml           | 2 ++
 4 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/.github/scripts/create-latest-alias.sh b/.github/scripts/create-latest-alias.sh
index 4a204e66d..522363999 100755
--- a/.github/scripts/create-latest-alias.sh
+++ b/.github/scripts/create-latest-alias.sh
@@ -8,11 +8,11 @@ latest_path=""
 
 for version_file in "$versions_dir"/*.yml; do
     candidate=$(awk '
-        $1 == "path:" {
+        /^path:/ {
             path = $2
             gsub(/^"|"$/, "", path)
         }
-        $1 == "defaultVersion:" && $2 == "true" {
+        /^defaultVersion:/ && $2 == "true" {
             default_version = 1
         }
         END {
diff --git a/.github/scripts/test-create-latest-alias.sh b/.github/scripts/test-create-latest-alias.sh
index 17e56587a..0508ba396 100755
--- a/.github/scripts/test-create-latest-alias.sh
+++ b/.github/scripts/test-create-latest-alias.sh
@@ -18,6 +18,9 @@ EOF
 cat > "$versions_dir/1.5.0.Final.yml" <<'EOF'
 path: "1_5_0_Final"
 defaultVersion: true
+menu:
+  - title: "Javadoc"
+    path: "/apidocs/"
 EOF
 
 "$script_dir/create-latest-alias.sh" "$versions_dir" "$site_dir"
diff --git a/.github/workflows/check-site.yml b/.github/workflows/check-site.yml
index 1ed8692b3..fa9d3b65c 100644
--- a/.github/workflows/check-site.yml
+++ b/.github/workflows/check-site.yml
@@ -4,6 +4,9 @@ on:
   pull_request:
     paths:
       - docs/**
+      - .github/scripts/**
+      - .github/workflows/check-site.yml
+      - .github/workflows/deploy-site.yml
 
 jobs:
   build:
@@ -17,6 +20,7 @@ jobs:
         with:
           site-directory: ./docs/
           github-pages: 'false'
+          site-url: https://a2aproject.github.io/a2a-java
       - name: Verify latest documentation alias
         run: |
           .github/scripts/create-latest-alias.sh docs/data/versions docs/target/roq
diff --git a/.github/workflows/deploy-site.yml b/.github/workflows/deploy-site.yml
index 7858265f2..918061012 100644
--- a/.github/workflows/deploy-site.yml
+++ b/.github/workflows/deploy-site.yml
@@ -5,6 +5,8 @@ on:
     branches: [ main ]   # Switch to the branch which should be deployed to GitHub Pages
     paths:
       - docs/**
+      - .github/scripts/**
+      - .github/workflows/deploy-site.yml
   workflow_dispatch:
 
 jobs: