ci(release): add documentation versioning to release workflow (#1120)

Automatically snapshots current documentation for each major.minor
release to provide historical versions.

Author: l2ysho

.github/workflows/release.yaml

@@ -239,6 +239,12 @@ jobs:
                           "tag": "latest"
                       }
 
+    version_docs:
+        name: Version docs
+        needs: [update_changelog, publish_to_npm]
+        uses: ./.github/workflows/version_docs.yaml
+        secrets: inherit
+
     update_homebrew_formula:
         name: Update Homebrew Formula
         needs: [update_changelog, publish_to_npm]

.github/workflows/version_docs.yaml

@@ -0,0 +1,49 @@
+name: Version docs
+
+on:
+    workflow_dispatch:
+    workflow_call:
+
+jobs:
+    version_docs:
+        name: Version docs
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v6
+              with:
+                  ref: ${{ github.event.repository.default_branch }}
+                  token: ${{ secrets.APIFY_SERVICE_ACCOUNT_GITHUB_TOKEN }}
+
+            - name: Use Node.js
+              uses: actions/setup-node@v6
+              with:
+                  node-version: 24
+
+            - name: Install pnpm and dependencies
+              uses: apify/workflows/pnpm-install@main
+
+            - name: Snapshot the current version
+              id: version
+              run: |
+                  VERSION=$(jq -r '.version' package.json)
+                  MAJOR_MINOR=$(echo "$VERSION" | cut -d. -f1,2)
+                  echo "version=$VERSION" >> $GITHUB_OUTPUT
+                  cd website
+                  rm -rf versioned_docs/version-$MAJOR_MINOR
+                  rm -rf versioned_sidebars/version-$MAJOR_MINOR-sidebars.json
+                  jq --arg v "$MAJOR_MINOR" 'map(select(. != $v))' versions.json > tmp.json && mv tmp.json versions.json
+                  pnpm exec docusaurus docs:version $MAJOR_MINOR
+
+            - name: Format
+              working-directory: website
+              run: pnpm run prettify
+
+            - name: Commit and push the version snapshot
+              uses: EndBug/add-and-commit@v10
+              with:
+                  author_name: Apify Release Bot
+                  author_email: noreply@apify.com
+                  message: "docs: version docs for ${{ steps.version.outputs.version }} [skip ci]"
+                  pull: "--rebase --autostash"