fix(docs): cache deployment reference build

.github/workflows/docs-pages.yml

@@ -124,6 +124,12 @@ jobs:
           cache: npm
           cache-dependency-path: docs/site/package-lock.json
 
+      - name: Cache Registryctl authoring-reference build
+        uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2
+        with:
+          key: docs-authoring-reference
+          save-if: true
+
       - name: Install docs dependencies
         working-directory: docs/site
         run: npm ci
@@ -230,10 +236,10 @@ jobs:
         id: deployment
         uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5
         with:
-          # GitHub Pages can remain queued beyond the action's ten-minute
-          # default even when no repository deployment is active. Keep the
-          # bounded wait, but tolerate a transient service-side queue.
-          timeout: 1200000
+          # State the action's maximum explicitly. A deployment that remains
+          # queued for ten minutes is a provider-side failure and is retried
+          # by relaunching this authenticated workflow.
+          timeout: 600000
 
       - name: Smoke live canonical deployment
         working-directory: docs/site

release/scripts/test_release_workflow_structure.py

@@ -611,7 +611,20 @@ def test_docs_deploy_rechecks_latest_published_release(self) -> None:
             if step.get("name") == "Deploy to GitHub Pages"
         )
         self.assertEqual(recheck + 1, deployment)
-        self.assertEqual(deploy_steps[deployment]["with"]["timeout"], 1_200_000)
+        self.assertEqual(deploy_steps[deployment]["with"]["timeout"], 600_000)
+
+        build_steps = document["jobs"]["build"]["steps"]
+        cache = next(
+            step
+            for step in build_steps
+            if step.get("name") == "Cache Registryctl authoring-reference build"
+        )
+        self.assertEqual(
+            cache["uses"],
+            "Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32",
+        )
+        self.assertEqual(cache["with"]["key"], "docs-authoring-reference")
+        self.assertTrue(cache["with"]["save-if"])
 
     def test_latest_release_fixture_rejects_stale_or_nonpublished_dispatches(
         self,