liuyu/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-06-06 05:51:15 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: document hourly translation debounce

Browse Source
This commit is contained in:
Peter Steinberger
2026-05-06 21:10:15 +01:00
parent a74b459f7a
commit 5d3d1f8718
1 changed files with 5 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/.i18n/translation-workflow.md
View File

@@ -16,7 +16,7 @@ Internal note for the docs publish pipeline. This file is under `docs/.i18n`, wh
1. `openclaw/openclaw` syncs English docs into `openclaw/docs`.
2. GitHub Pages deploys English/source changes immediately from the sync commit.
3. `Translate All` is triggered by the sync commit, release dispatch, manual dispatch, or weekly schedule.
4. The coordinator waits a short cooldown window before starting translation.
4. The coordinator waits a cooldown window before starting translation.
5. After the cooldown, the coordinator reads the current `origin/main` source metadata.
6. If a newer docs sync arrived during cooldown, the coordinator uses the newer source state.
7. Per-locale translation jobs run in parallel with `fail-fast: false`.
@@ -27,9 +27,11 @@ Internal note for the docs publish pipeline. This file is under `docs/.i18n`, wh
## Debounce policy
The coordinator waits 5 minutes after a docs sync or release dispatch, then re-reads `origin/main`.
The coordinator waits 1 hour after a docs sync or release dispatch, then re-reads `origin/main`.
If `.openclaw-sync/source.json` changed during the wait, it waits again from the newer state. If `main` keeps moving, the wait is capped at 20 minutes and the newest observed state is translated.
The default cooldown is controlled by the publish repo variable `OPENCLAW_DOCS_TRANSLATION_COOLDOWN_SECONDS`, which defaults to `3600`. Repository dispatch callers may override it with `client_payload.cooldown_seconds`, and manual runs may set `cooldown_seconds`.
If `.openclaw-sync/source.json` changed during the wait, it waits again from the newer state. If `main` keeps moving, the wait is capped by `OPENCLAW_DOCS_TRANSLATION_MAX_WAIT_SECONDS`, which defaults to the cooldown value. The newest observed state is translated after the cap.
Manual and weekly runs do not wait by default.