Skip to content

docs: add Chinese (zh-CN) translation of README#2259

Closed
ruguoba wants to merge 4 commits into
Canner:mainfrom
ruguoba:translate-zh
Closed

docs: add Chinese (zh-CN) translation of README#2259
ruguoba wants to merge 4 commits into
Canner:mainfrom
ruguoba:translate-zh

Conversation

@ruguoba
Copy link
Copy Markdown

@ruguoba ruguoba commented May 12, 2026

添加 README 的中文翻译版本。

Changes

  • 新增 — README 的完整中文翻译
  • 在英文 README 中添加语言切换链接

Motivation

让更多中文开发者能够更好地了解和使用 WrenAI 项目。

Summary by CodeRabbit

  • Documentation
    • Added a language selector to the README to switch between English and Chinese.
    • Published a comprehensive Chinese README with logo/links, project overview, quick start, CLI/manual install pointers, docs and connector lists, repo structure, supported data sources, community/license info, contributor badge, and footer navigation.

Review Change Stack

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 12, 2026
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 12, 2026

Walkthrough

Adds a language selector to README.md and adds a new, comprehensive Chinese README (README_zh.md) with badges, announcement, feature overview, quick start, docs/data-source listings, repository structure, community info, and license/contributor details.

Changes

Chinese README Localization

Layer / File(s) Summary
Language selector in English README
README.md
Added a language toggle row linking to the English README (current page) and Chinese README translation.
Chinese README documentation
README_zh.md
Created complete Chinese README containing header with logo/badges and announcement; language toggle; "Why choose WrenAI?" and quick start with npx/install hints; documentation and supported data-source connector list; repository structure table; community links, license mapping, contributor badges, and footer navigation.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

Suggested labels

documentation

Suggested reviewers

  • cyyeh
  • wwwy3y3

Poem

🐰 我是小兔来报喜,README 中英两相宜,
徽章闪耀头版里,快速上手一步齐,
欢迎四海朋友来,文档同享好时光。

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding a Chinese translation of the README file with a language selector.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README_zh.md`:
- Line 5: Three <img> tags are missing alt attributes causing
accessibility/MD045 failures; update each <img> tag (including the one with
src="./misc/wrenai_logo_white.png" and the other two images referenced at the
same locations) to include a concise, descriptive alt attribute (e.g.,
alt="WrenAI logo" or an appropriate description for each image) so screen
readers and markdownlint MD045 are satisfied; ensure you add meaningful alt text
rather than empty strings unless the image is purely decorative.
- Line 27: The aria-label on the anchor element with
href="https://discord.gg/5DvshJqG8Z" is incorrect ("Join the community on
GitHub"); update that aria-label to accurately reflect the destination (e.g.,
"Join the community on Discord") so assistive technologies convey the correct
link target; locate the anchor tag in README_zh.md containing aria-label and the
Discord href and replace the label text accordingly.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: c00d2f9f-90f5-434e-be0b-832eb4f86a7c

📥 Commits

Reviewing files that changed from the base of the PR and between ba187b7 and 22b46de.

📒 Files selected for processing (2)
  • README.md
  • README_zh.md

Comment thread README_zh.md Outdated
<a href="https://getwren.ai/?utm_source=github&utm_medium=title&utm_campaign=readme">
<picture>
<source media="(prefers-color-scheme: light)" srcset="./misc/wrenai_logo.png">
<img src="./misc/wrenai_logo_white.png" width="300px">
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add missing alt text to images (Line 5, Line 31, Line 135).

These <img> tags are missing alt, which hurts screen-reader accessibility and triggers markdownlint MD045.

Suggested patch
-      <img src="./misc/wrenai_logo_white.png" width="300px">
+      <img src="./misc/wrenai_logo_white.png" width="300px" alt="WrenAI logo">
...
-    <img src="https://img.shields.io/badge/%F0%9F%A7%A1-Made%20by%20Canner-blue?style=for-the-badge">
+    <img src="https://img.shields.io/badge/%F0%9F%A7%A1-Made%20by%20Canner-blue?style=for-the-badge" alt="Made by Canner badge">
...
-  <img src="https://contrib.rocks/image?repo=Canner/WrenAI" />
+  <img src="https://contrib.rocks/image?repo=Canner/WrenAI" alt="Project contributors" />

Also applies to: 31-31, 135-135

🧰 Tools
🪛 markdownlint-cli2 (0.22.1)

[warning] 5-5: Images should have alternate text (alt text)

(MD045, no-alt-text)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README_zh.md` at line 5, Three <img> tags are missing alt attributes causing
accessibility/MD045 failures; update each <img> tag (including the one with
src="./misc/wrenai_logo_white.png" and the other two images referenced at the
same locations) to include a concise, descriptive alt attribute (e.g.,
alt="WrenAI logo" or an appropriate description for each image) so screen
readers and markdownlint MD045 are satisfied; ensure you add meaningful alt text
rather than empty strings unless the image is purely decorative.

Comment thread README_zh.md Outdated
@ruguoba
Copy link
Copy Markdown
Author

ruguoba commented May 13, 2026

Thank you for the review! I have fixed all the issues:

  1. Added alt text to images:

    • Logo image: alt="WrenAI logo"
    • Canner badge: alt="Made by Canner"
  2. Fixed aria-label on Discord link: Changed from "Join the community on GitHub" to "Join the community on Discord"

Please let me know if there are any other changes needed!

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

♻️ Duplicate comments (1)
README_zh.md (1)

135-135: ⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add missing alt text to contributors image.

The contributors image at line 135 is still missing the alt attribute, which was flagged in the previous review. This affects accessibility for screen readers.

♿ Proposed fix
-  <img src="https://contrib.rocks/image?repo=Canner/WrenAI" />
+  <img src="https://contrib.rocks/image?repo=Canner/WrenAI" alt="Project contributors" />
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README_zh.md` at line 135, The contributors image tag (<img
src="https://contrib.rocks/image?repo=Canner/WrenAI" />) is missing an alt
attribute; update that <img> element in README_zh.md to include a meaningful alt
text (e.g., alt="Contributors") so screen readers can describe the image,
ensuring the tag becomes <img
src="https://contrib.rocks/image?repo=Canner/WrenAI" alt="Contributors" /> (or
another appropriate descriptive string).
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Duplicate comments:
In `@README_zh.md`:
- Line 135: The contributors image tag (<img
src="https://contrib.rocks/image?repo=Canner/WrenAI" />) is missing an alt
attribute; update that <img> element in README_zh.md to include a meaningful alt
text (e.g., alt="Contributors") so screen readers can describe the image,
ensuring the tag becomes <img
src="https://contrib.rocks/image?repo=Canner/WrenAI" alt="Contributors" /> (or
another appropriate descriptive string).

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: bd95413a-ebd7-4a20-aa37-8a9c844b2023

📥 Commits

Reviewing files that changed from the base of the PR and between 22b46de and 696a730.

📒 Files selected for processing (1)
  • README_zh.md

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
README_zh.md (1)

135-135: ⚡ Quick win

Improve the alt text for better accessibility.

The contributors image uses generic alt text "image". While this satisfies the technical requirement for alt attributes, it doesn't provide meaningful information to screen reader users.

♻️ Suggested improvement
-  <img alt="image" src="https://contrib.rocks/image?repo=Canner/WrenAI" />
+  <img alt="Project contributors" src="https://contrib.rocks/image?repo=Canner/WrenAI" />
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README_zh.md` at line 135, The image tag in README_zh.md uses a
non-descriptive alt text ("image"); update the alt attribute on the <img>
element (the line with <img alt="image"
src="https://contrib.rocks/image?repo=Canner/WrenAI" />) to a meaningful
description such as "Contributors to the WrenAI repository" or "WrenAI
contributors graph" so screen readers convey useful context.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@README_zh.md`:
- Line 135: The image tag in README_zh.md uses a non-descriptive alt text
("image"); update the alt attribute on the <img> element (the line with <img
alt="image" src="https://contrib.rocks/image?repo=Canner/WrenAI" />) to a
meaningful description such as "Contributors to the WrenAI repository" or
"WrenAI contributors graph" so screen readers convey useful context.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: acfe424b-ca20-4dee-b11d-1c7a9e17ee98

📥 Commits

Reviewing files that changed from the base of the PR and between 696a730 and e9dee50.

📒 Files selected for processing (1)
  • README_zh.md

@ruguoba
Copy link
Copy Markdown
Author

ruguoba commented May 13, 2026

Closing this PR to clean up my contribution queue. Thank you for your time.

@ruguoba ruguoba closed this May 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant