ci: pass bumped version and post-bump ref to docs jobs in release flow (#806)

## Summary

The v3.0.0 release versioned the docs as `2.5` instead of `3.0`
(overwriting v2.5 content with v3). Root cause:
`manual_version_docs.yaml` reads `uv version --short` from a checkout of
the workflow's dispatch ref (pre-bump), so the job sees the old version.
Run
[#26156928273](https://github.com/apify/apify-client-python/actions/runs/26156928273)
logged `Version: 2.5.1, Major.Minor: 2.5, Major: 2`; bad output is
commit e0a0bc8.

## Fix

- `manual_version_docs.yaml` — optional `version_number` input; snapshot
step uses it when set, falls back to `uv version --short` for manual
dispatch.

Companion data-restore PR: #808.

Author: vdusek

.github/workflows/manual_release_stable.yaml

@@ -119,6 +119,10 @@ jobs:
     permissions:
       contents: write
     uses: ./.github/workflows/manual_version_docs.yaml
+    with:
+      # Pass the bumped version explicitly — the job's checkout uses the dispatch ref (pre-bump),
+      # so `uv version --short` from pyproject.toml would return the old version.
+      version_number: ${{ needs.release_prepare.outputs.version_number }}
     secrets: inherit
 
   doc_release:

.github/workflows/manual_version_docs.yaml

@@ -3,9 +3,21 @@ name: Version docs
 on:
   # Runs when manually triggered from the GitHub UI.
   workflow_dispatch:
+    inputs:
+      version_number:
+        description: Version to snapshot (e.g. "1.0.0"). If empty, the current version in pyproject.toml is used.
+        required: false
+        type: string
+        default: ""
 
   # Runs when invoked by another workflow.
   workflow_call:
+    inputs:
+      version_number:
+        description: Version to snapshot (e.g. "1.0.0"). If empty, the current version in pyproject.toml is used.
+        required: false
+        type: string
+        default: ""
 
 concurrency:
   group: version-docs
@@ -56,11 +68,19 @@ jobs:
 
       - name: Snapshot the current version
         id: snapshot
+        env:
+          INPUT_VERSION: ${{ inputs.version_number }}
         run: |
           cd website
 
-          # Extract version from pyproject.toml.
-          FULL_VERSION="$(uv version --short)"
+          # Prefer the explicit input (passed by the release workflow after the version bump).
+          # Fall back to pyproject.toml only when run manually without an input — this avoids
+          # the stale-checkout pitfall where the bumped version isn't visible to this job.
+          if [[ -n "$INPUT_VERSION" ]]; then
+            FULL_VERSION="$INPUT_VERSION"
+          else
+            FULL_VERSION="$(uv version --short)"
+          fi
           MAJOR_MINOR_VERSION="$(echo "$FULL_VERSION" | cut -d. -f1-2)"
           MAJOR_VERSION="$(echo "$FULL_VERSION" | cut -d. -f1)"
           echo "version=$FULL_VERSION" >> "$GITHUB_OUTPUT"