docs: clarify post-deploy smoke

This commit is contained in:
Peter Steinberger
2026-05-06 20:45:30 +01:00
parent b0bc29ea6a
commit 9dca1ff672

View File

@@ -22,7 +22,8 @@ Internal note for the docs publish pipeline. This file is under `docs/.i18n`, wh
7. Per-locale translation jobs run in parallel with `fail-fast: false`.
8. Each locale job uploads an artifact for the requested source SHA.
9. The finalizer downloads available artifacts, ignores stale or failed payloads, and pushes one aggregate i18n commit.
10. After the aggregate commit lands, the finalizer dispatches the Pages deploy and live smoke workflows once.
10. After the aggregate commit lands, the finalizer dispatches the Pages deploy once.
11. The Pages workflow dispatches live smoke after deployment.
## Debounce policy
@@ -99,7 +100,7 @@ The weekly run is the repair mechanism for LLM flakiness, partial failures, and
English deploys from source sync commits.
Translations deploy after the aggregate i18n commit. The finalizer dispatches GitHub Pages and live smoke once because GitHub suppresses normal push-triggered workflow runs from `GITHUB_TOKEN` commits.
Translations deploy after the aggregate i18n commit. The finalizer dispatches GitHub Pages once because GitHub suppresses normal push-triggered workflow runs from `GITHUB_TOKEN` commits. The Pages workflow dispatches live smoke after deployment so the smoke test checks the deployed site instead of racing the deploy.
A hot docs day should produce many fast English deploys, but only a small number of locale deploys.