Add create-release script + workflow (#1392)

Author: krinart

.github/workflows/create_release.yml

@@ -0,0 +1,47 @@
+name: Create Versioned Docs Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version number (e.g. 2.0)"
+        required: true
+        type: string
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  create-release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout trunk
+        uses: actions/checkout@v4
+        with:
+          ref: trunk
+
+      - name: Create release branch and run release script
+        working-directory: website
+        run: |
+          git checkout -b "release/docs-v${{ inputs.version }}"
+          ./create-release.sh "${{ inputs.version }}"
+
+      - name: Commit and push
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add -A
+          git commit -m "Add versioned docs for v${{ inputs.version }}"
+          git push origin "release/docs-v${{ inputs.version }}"
+
+      - name: Create Pull Request
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh pr create \
+            --base trunk \
+            --head "release/docs-v${{ inputs.version }}" \
+            --title "Add versioned docs for v${{ inputs.version }}" \
+            --body "Creates versioned documentation snapshot for v${{ inputs.version }}." \
+            --label "area/docs"

website/create-release.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Creates a new versioned documentation release.
+#
+# Usage:
+#   ./create-release.sh <version>
+#
+# Example:
+#   ./create-release.sh 2.1
+#
+# This will:
+#   1. Copy docs/ to versioned_docs/version-2.1.x/
+#   2. Prepend "2.1.x" to versions.json
+#   3. Create versioned_sidebars/version-2.1.x-sidebars.json from sidebars.ts
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+if [ $# -ne 1 ]; then
+  echo "Usage: $0 <version>"
+  echo "Example: $0 2.1"
+  exit 1
+fi
+
+VERSION="$1"
+VERSION_LABEL="${VERSION}.x"
+VERSIONED_DOCS_DIR="versioned_docs/version-${VERSION_LABEL}"
+SIDEBAR_FILE="versioned_sidebars/version-${VERSION_LABEL}-sidebars.json"
+
+# Validate that the version doesn't already exist
+if [ -d "$VERSIONED_DOCS_DIR" ]; then
+  echo "Error: Version ${VERSION_LABEL} already exists at ${VERSIONED_DOCS_DIR}"
+  exit 1
+fi
+
+if grep -q "\"${VERSION_LABEL}\"" versions.json; then
+  echo "Error: Version ${VERSION_LABEL} already listed in versions.json"
+  exit 1
+fi
+
+# Step 1: Copy docs/ to versioned_docs/version-<version>.x/
+echo "Copying docs/ to ${VERSIONED_DOCS_DIR}/"
+cp -r docs "$VERSIONED_DOCS_DIR"
+
+# Step 2: Prepend version to versions.json
+echo "Adding \"${VERSION_LABEL}\" to versions.json"
+EXISTING=$(cat versions.json)
+echo "$EXISTING" | python3 -c "
+import json, sys
+versions = json.load(sys.stdin)
+versions.insert(0, '${VERSION_LABEL}')
+print(json.dumps(versions, indent=4))
+" > versions.json
+
+# Step 3: Create sidebar file by converting sidebars.ts to JSON
+# Use the same structure as existing versioned sidebar files
+echo "Creating ${SIDEBAR_FILE}"
+# Extract the sidebar JSON from the most recent versioned sidebar as a template,
+# since all versioned sidebars match the current sidebars.ts structure.
+LATEST_SIDEBAR=$(ls -1 versioned_sidebars/*.json 2>/dev/null | sort -V | tail -1)
+
+if [ -n "$LATEST_SIDEBAR" ]; then
+  cp "$LATEST_SIDEBAR" "$SIDEBAR_FILE"
+else
+  # Fallback: generate from the known structure in sidebars.ts
+  cat > "$SIDEBAR_FILE" << 'EOF'
+{
+  "docs": [{ "type": "autogenerated", "dirName": "." }],
+  "api": [
+    "api/overview",
+    "api/arrow-flight-sql/index",
+    "api/jdbc/index",
+    "api/odbc/index",
+    "api/auth/index",
+    "api/tls/index",
+    {
+      "type": "category",
+      "label": "HTTP",
+      "collapsible": true,
+      "collapsed": false,
+      "items": [{ "type": "autogenerated", "dirName": "api/HTTP" }]
+    }
+  ]
+}
+EOF
+fi
+
+echo ""
+echo "Release ${VERSION_LABEL} created successfully!"
+echo ""
+echo "Files created/modified:"
+echo "  - ${VERSIONED_DOCS_DIR}/ (copied from docs/)"
+echo "  - versions.json (updated)"
+echo "  - ${SIDEBAR_FILE} (created)"