From db915617ad3eb4c02061c76d7912e9e512a7f8f2 Mon Sep 17 00:00:00 2001
From: Vasily Pelikh <2010720+vpelikh@users.noreply.github.com>
Date: Fri, 28 Aug 2026 12:56:37 +0300
Subject: [PATCH] Fix release workflow: checkout gh-pages to a separate path

The release job checked out the gh-pages branch in-place (workspace root) after
the composite 'Build and test plugins' action. GitHub runs a composite action's
post step at the end of the job, by which point the working tree had been swapped
to gh-pages content (which has no .github), so the runner could not find the
action.yml and the post step failed with 'Did you forget to run actions/checkout
before running your local action?'.

Check out gh-pages into a dedicated 'gh-pages' subdirectory and cd into it for the
publish step, keeping the workspace root (and its .github) intact for the whole
job including the composite action's post step.
---
 .github/workflows/release.yml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index e6c3959f8..64ec46464 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -103,15 +103,21 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
+      # Check out gh-pages into a separate path. A checkout into the workspace root
+      # would swap the working tree to the gh-pages content (no .github), which makes
+      # the composite "Build and test plugins" action's post step fail because its
+      # action.yml metadata can no longer be found at job end.
       - name: Checkout gh-pages
         uses: actions/checkout@v7
         with:
           ref: "gh-pages"
           fetch-depth: 0
+          path: gh-pages
 
       - name: Publish javadocs
         if: success()
         run: |
+          cd gh-pages
           TMPDIR="$(dirname -- "${0}")"
           . $TMPDIR/publish-javadocs.sh