From a02e69a4efa321a133843ce8d6c5b647bf2dc525 Mon Sep 17 00:00:00 2001
From: "bedrock-python-assets-write[bot]"
 <339090477+bedrock-python-assets-write[bot]@users.noreply.github.com>
Date: Wed, 7 Oct 2026 12:48:43 +0000
Subject: [PATCH] chore: sync engineering assets

Touchmark-Hub: bedrock-python@github.com/1408350934
Touchmark-Stream: sync
Touchmark-Content: sha256:be76091b6e79b9f04dc6b7c725b2639e88f4b5f0ccc6728fc4be19a761b09661
Touchmark-Hub-Commit: 3d6fd668ded1e7b2b5bc68551b34571ef8cd8fa4
---
 .github/workflows/docs.yml | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 0b71e78..ba8700d 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -3,22 +3,31 @@ name: Docs
 on:
   push:
     branches: [master]
+  workflow_dispatch:
 
 permissions:
   contents: read
   pages: write
   id-token: write
 
+# Two quick pushes must not race each other onto Pages.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
       - uses: astral-sh/setup-uv@v7
-      - run: uv sync --no-dev --group docs
+      # --locked: fail when uv.lock is out of date with pyproject.toml.
+      - run: uv sync --locked --no-dev --group docs
       - run: cp CHANGELOG.md docs/changelog.md
-      - run: uv run zensical build --clean
-      - run: uv run python scripts/emit_markdown.py
+      # --no-dev on `uv run` too: without it the implicit sync reinstalls the
+      # whole dev group just to build docs.
+      - run: uv run --no-dev --group docs zensical build --clean
+      - run: uv run --no-dev --group docs python scripts/emit_markdown.py
       - uses: actions/upload-pages-artifact@v5
         with:
           path: site