Skip to content

docs(i18n): refresh 6 drifted docs and re-translate stale mirrors found by a full audit - #15335

Merged
diegosouzapw merged 50 commits into
release/v3.8.52from
docs/i18n-stale-mirrors-852b
Oct 2, 2026
Merged

diegosouzapw merged 50 commits into
release/v3.8.52from
docs/i18n-stale-mirrors-852b

Conversation

@diegosouzapw

Copy link
Copy Markdown
Owner

Summary

This PR has two parts:

  • Drift: it refreshes every locale of the 6 docs the base edited without updating their translations: QUALITY_GATES, ACP, AGENT_PROTOCOLS_GUIDE, CLI-INTEGRATIONS, API_REFERENCE and ENVIRONMENT.
  • Stale mirrors: it re-translates mirrors that were stale even though check-translation-drift reported them as up to date.

The drift check only compares hashes. A mirror whose recorded hash matched, but whose content came from an older source or had lost sections, stayed green. Two audits over all 10032 mirrors found them:

  1. Structure: heading, code-fence and table-row counts against the current English source.
  2. Inline code spans: code spans are kept verbatim by translation, so a mirror missing many of its source's spans is stale or truncated.

Examples:

  • 37 FLY_IO_DEPLOYMENT_GUIDE mirrors were missing 2 sections and 6 fences.
  • 13 FREE_PROXIES_API mirrors were stale.
  • The Turkish README was 60 lines short, with a v3.8.49 footer.

42 docs were force-re-translated. CLAUDE.md / GEMINI.md mirrors are handled separately in #15329 (agent-instruction surfaces).

524 mirror files change in total. Only docs/i18n/** and .i18n-state.json change.

Validation

  • check-translation-drift: PASS (0 stale).
  • i18n:check-keys, i18n:check-ratio, check:docs-sync: pass.
  • Every changed mirror passed the output guard and a structure/leak check against the base: 0 structural regressions and 0 leaks.
  • After the re-translation, the structure audit only flags the CLAUDE.md / GEMINI.md mirrors fixed in docs: correct the db module count to 137 and re-translate stale CLAUDE.md/GEMINI.md mirrors #15329. The span audit leaves 15 known false positives in docs with few spans, where prose inside backticks is translated on purpose (e.g. Total: N → Gesamt: N).

⚠️ base-red inherited: #15306

@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

CI Coverage Report

  • Coverage job: success
  • PR test policy: success

Coverage artifact was not available for this run.

@diegosouzapw
diegosouzapw merged commit 2d8e7ed into release/v3.8.52 Oct 2, 2026
48 of 51 checks passed
@diegosouzapw
diegosouzapw deleted the docs/i18n-stale-mirrors-852b branch October 2, 2026 09:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant