Skip to content

Conversation

@Thulof
Copy link

@Thulof Thulof commented Jan 14, 2026

Description

This PR adds full Simplified Chinese (zh-CN) translation support for the A2UI documentation.

Changes

  • Translation: Added translated markdown files in docs/zh/ mirroring the structure of the original docs/.
  • Configuration: Updated mkdocs.yaml to enable the zh locale using mkdocs-static-i18n plugin and added a localized navigation bar (nav_translations).
  • Specification Sourcing: The translated specification files (docs/zh/specification/*.md) directly reference the original English specification files (e.g., in specification/v0_8/docs/) using the snippet inclusion syntax (--8<--). This ensures the technical specification remains a single source of truth while the wrapper content is localized.

Pre-launch Checklist

If you need help, consider asking for advice on the discussion board.

@google-cla
Copy link

google-cla bot commented Jan 14, 2026

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@Thulof Thulof marked this pull request as draft January 14, 2026 08:42
Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces Simplified Chinese (zh-CN) translations for the documentation and configures i18n support using mkdocs-static-i18n. The changes are well-structured and effectively add localization. I've identified a few minor grammatical issues and typos in the new Chinese markdown files, along with one broken video link due to a typo in a filename. The configuration changes in mkdocs.yaml and requirements-docs.txt appear correct for enabling internationalization. Overall, this is a valuable addition that improves the accessibility of the documentation.

@Thulof Thulof marked this pull request as ready for review January 14, 2026 08:47
- Translated all documentation files in `docs/` to `docs/zh/`.
- Configured `mkdocs.yaml` for i18n support with `zh` locale and localized navigation.
- Updated `specification` files to reference original English sources using `!--8<--` syntax to maintain single source of truth.
Thulof and others added 2 commits January 14, 2026 16:58
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@Thulof
Copy link
Author

Thulof commented Jan 15, 2026

Hi @jacobsimionato ,
Could you please take a look at this Pull Request? The documentation was primarily translated by Gemini 3 Pro, and I have personally reviewed and refined the content to ensure accuracy. Thanks!

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