Seed pip caches for docs on `main`/`3.x` branches (#153127)

diff --git a/.github/workflows/reusable-docs.yml b/.github/workflows/reusable-docs.yml
index a792553a63b8bab2fd5c1768dd9037bbf1009c3d..199e0fd8d181f0bbbb61911112b0d19cd45ac111 100644 (file)
--- a/.github/workflows/reusable-docs.yml
+++ b/.github/workflows/reusable-docs.yml
@@ -3,6 +3,17 @@ name: Reusable Docs
 on:
   workflow_call:
   workflow_dispatch:
+  # Pushes to CPython branches seed the pip caches under the exact keys every
+  # docs PR restores from. Without a branch-scoped copy, each PR saves a
+  # duplicate into its own refs/pull/N/merge scope that nothing else can read.
+  push:
+    branches:
+      - main
+      - '3.*'
+    paths:
+      - 'Doc/pylock.toml'
+      - 'Doc/requirements.txt'
+      - '.github/workflows/reusable-docs.yml'
 
 permissions:
   contents: read