Skip to content

docs: translate the changes that landed after #1115's translation commit - #1117

Merged
cogwirrel merged 1 commit into
mainfrom
docs/translate-1115-followup
Aug 24, 2026
Merged

docs: translate the changes that landed after #1115's translation commit#1117
cogwirrel merged 1 commit into
mainfrom
docs/translate-1115-followup

Conversation

@nx-plugin-for-aws

Copy link
Copy Markdown
Collaborator

Reason for this change

#1115 landed its docs: update translations commit before its final review-feedback commit, so the English changes in that last commit were never translated. The eight non-English copies of three guides still carry content that no longer exists in the English source.

Concretely, dede1d9 (the last commit on #1115) edited en/guides/py-agent.mdx, en/guides/trpc.mdx and en/guides/ts-agent.mdx, and the translation workflow had already run at that point. On main today:

  • trpc.mdx — all 8 languages still contain two blocks the reviewer deliberately removed: the :::caution[Claims location differs by API type] admonition and the :::note[Cognito authentication] client-token example.
  • ts-agent.mdx / py-agent.mdx — all 8 languages still contain the trailing sentence "Set it on the runtime to advertise the deployed agent's public URL.", dropped from the A2A server sections.

This is a translation catch-up only; no English or source changes.

Description of changes

Ran scripts/translate.ts locally against the three guides, which retranslated them into all eight target languages (24 files).

The translating agent also made a number of edits unrelated to the diff it was given, which I reverted so the commit contains only the intended catch-up:

  • zh/guides/trpc.mdx — rewrote ASCII commas and colons as full-width CJK punctuation throughout the file (147 lines touched). Rebuilt from main with only the two blocks excised.
  • es/guides/py-agent.mdx and jp/guides/ts-agent.mdx — rewrote Astro.currentLocale || 'en' fallbacks in <Link> hrefs to || 'es' / || 'jp', which would change routing behaviour. Rebuilt from main with only the sentence removed.
  • es/ and pt/guides/ts-agent.mdx — reworded an unchanged sentence about client class naming. Reverted.

The result is uniform across languages: 0/17 for every trpc.mdx, and 1–2 lines for each agent guide.

Description of how you validated changes

  • Confirmed the stale content is gone in all 8 languages, and that each affected sentence now ends where the English does.
  • docs:build passes with no errors (the remaining astro-expressive-code warnings about gitignore/ejs languages are pre-existing on main and unrelated).
  • Audited the per-file diffstat to check every remaining change corresponds to a real English change — the one multi-line agent-guide change that is not a pure removal is the AG-UI paragraph, which docs: correct code snippets and claims that don't match generated output #1115 genuinely simplified in English (it no longer mentions addPing / createStrandsApp), so translating it is correct.

Committing the translations here rather than letting the bot generate them means merging this does not trigger a follow-up translation commit and CI restart.

Issue # (if applicable)

N/A — follow-up to #1115.

Checklist


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

@codecov-commenter

codecov-commenter commented Aug 24, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 88.34%. Comparing base (7b8167f) to head (5e946a9).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1117   +/-   ##
=======================================
  Coverage   88.34%   88.34%           
=======================================
  Files         227      227           
  Lines        9698     9698           
  Branches     2301     2301           
=======================================
  Hits         8568     8568           
  Misses        498      498           
  Partials      632      632           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@cogwirrel
cogwirrel merged commit 9e716ee into main Aug 24, 2026
60 of 61 checks passed
@cogwirrel
cogwirrel deleted the docs/translate-1115-followup branch August 24, 2026 13:28
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.

3 participants