Skip to content

docs(i18n): add zh-CN translation for developing/README.md (C2b)#2506

Merged
senamakel merged 1 commit into
tinyhumansai:mainfrom
JAYcodr:docs/i18n-batch-c2b-developing-readme
May 22, 2026
Merged

docs(i18n): add zh-CN translation for developing/README.md (C2b)#2506
senamakel merged 1 commit into
tinyhumansai:mainfrom
JAYcodr:docs/i18n-batch-c2b-developing-readme

Conversation

@JAYcodr
Copy link
Copy Markdown
Contributor

@JAYcodr JAYcodr commented May 22, 2026

docs(i18n): add zh-CN translation for developing/README.md (C2b)

Translates the developing directory landing page for Chinese contributors.

  • Links localized to .zh-CN.md targets where available (C1 + C2 docs)
  • Retains English links for pages not yet translated
  • Follows terminology-zh-CN.md: Tauri 壳层, 智能体, sidecar, vendored, etc.
  • Adds lang: zh-CN frontmatter for GitBook multi-language rendering

Summary

  • Add zh-CN translation for gitbooks/developing/README.md, the landing page for contributor docs
  • Localize internal links to point to existing C1/C2 zh-CN translations
  • Retain English links for pages not yet translated (cloud-deploy, tool-memory, etc.)
  • Add lang: zh-CN frontmatter for GitBook multi-language rendering
  • 此 PR 建议在 C1 / C2 合并后合并,以确保所有 .zh-CN.md 内部链接指向的目标文件已存在于 main 分支。

Problem

The developing/ directory landing page was English-only, creating friction for Chinese-speaking contributors trying to navigate build instructions, architecture docs, and testing guides from the entry point.

Solution

Created developing/README.zh-CN.md with full translation while preserving:

  • Original frontmatter structure with lang: zh-CN added
  • Untranslated code blocks, CLI commands, and brand names
  • Technical terms per project convention (Tauri, Rust, sidecar, vendored, etc.)
  • Internal links routed to .zh-CN.md counterparts where C1/C2 translations exist

Submission Checklist

  • Tests added or updated — N/A: documentation-only change, no executable code modified
  • Diff coverage ≥ 80% — N/A: only .md file added, no testable source lines changed
  • Coverage matrix updated — N/A: no feature IDs or testable behavior changed
  • All affected feature IDs from the matrix are listed — N/A: no matrix entries affected
  • No new external network dependencies introduced — N/A: documentation only
  • Manual smoke checklist updated — N/A: no release-cut surfaces touched
  • Linked issue closed — N/A: no pre-existing issue for this docs batch

Impact

  • Runtime/platform impact: None
  • Performance/security/migration/compatibility: None
  • User-visible effect: Chinese contributors now see a localized landing page when entering the developing docs section

Related

  • Follow-up PR(s)/TODOs: Batch D (features cleanup: cloud-deploy, tool-memory, troubleshooting) and Batch E (legal + root docs) pending

AI Authored PR Metadata

Linear Issue

  • Key: N/A
  • URL: N/A

Commit & Branch

  • Branch: docs/i18n-batch-c2b-developing-readme
  • Commit SHA: 68852af61384ad43b4098d07f088a243a990fc1c

Validation Run

  • pnpm --filter openhuman-app format:check — N/A: no source code changed
  • pnpm typecheck — N/A: no TypeScript changed
  • Focused tests — N/A: docs-only
  • Rust fmt/check — N/A: no Rust changed
  • Tauri fmt/check — N/A: no Tauri changed

Validation Blocked

  • command: N/A
  • error: N/A
  • impact: N/A

Behavior Changes

  • Intended behavior change: None
  • User-visible effect: Chinese developing docs landing page now available

Parity Contract

  • Legacy behavior preserved: N/A
  • Guard/fallback/dispatch parity checks: N/A

Duplicate / Superseded PR Handling

  • Duplicate PR(s): None
  • Canonical PR: This PR
  • Resolution: N/A

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive Chinese developer guide covering repository overview, code structure, development setup, core build and architecture, frontend and shell layers, server details, layered testing and coverage gates, release and cloud deployment procedures, advanced exploration pointers (agents, CEF, subconscious loop), and contribution guidelines (PR targets, templates, focused changes).

Review Change Stack

@JAYcodr JAYcodr requested a review from a team May 22, 2026 22:24
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 22, 2026

📝 Walkthrough

Walkthrough

Adds a new Chinese developer guide at gitbooks/developing/README.zh-CN.md covering repository overview, code structure, onboarding steps, testing requirements (≥80% coverage gate), release/deployment entry points, architecture deep-dives, and contribution guidelines.

Changes

Developer Documentation

Layer / File(s) Summary
Chinese developer guide document
gitbooks/developing/README.zh-CN.md
New Chinese-language developer guide including metadata, repository overview and GPLv3 note, code structure map (app/, src/, gitbooks/, etc.), “Getting started” onboarding path, testing layers and PR coverage gate (≥80%), release and cloud deployment entry points, architecture deep-dive links (Agent Harness, CEF, Subconscious Loop), and contribution rules (PR target main, templates, focused changes).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested labels

working

Suggested reviewers

  • senamakel
  • graycyrus

Poem

🐇 在代码林中我轻跳,披露路标与门道,
从搭建到发布每一步都写好,
测试门槛摆在前方,覆盖率旗帜高高飘,
贡献者跟随指南来,项目更明了。 ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately reflects the primary change: adding a Chinese translation (zh-CN) for the developing/README.md file, which is exactly what the changeset contains.
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.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

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


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.

@coderabbitai coderabbitai Bot added the working A PR that is being worked on by the team. label May 22, 2026
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: 1

🤖 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 `@gitbooks/developing/README.zh-CN.md`:
- Line 20: 在 README 行中把误写的 Rust crate 名称 `openhuman_core` 改为正确的库 crate 名称
`openhuman`,并保留/明确指出 `openhuman-core` 是 CLI binary;查找包含字符串 `src/` 和
`openhuman_core` 的这一描述行并替换为表述:`src/` 对应 Rust 库 crate `openhuman`,并包含
`openhuman-core` CLI 二进制文件。
🪄 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: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 290e30a5-e825-415f-b34b-d0dd4f637fc0

📥 Commits

Reviewing files that changed from the base of the PR and between 788087c and 68852af.

📒 Files selected for processing (1)
  • gitbooks/developing/README.zh-CN.md

Comment thread gitbooks/developing/README.zh-CN.md Outdated
Translates the developing directory landing page for Chinese contributors.
- Links localized to .zh-CN.md targets where available (C1 + C2 docs)
- Retains English links for pages not yet translated
- Follows terminology-zh-CN.md: Tauri 壳层, 智能体, sidecar, vendored, etc.
- Adds lang: zh-CN frontmatter for GitBook multi-language rendering
@JAYcodr JAYcodr force-pushed the docs/i18n-batch-c2b-developing-readme branch from 68852af to 2778abb Compare May 22, 2026 22:28
@senamakel senamakel merged commit 533208b into tinyhumansai:main May 22, 2026
29 checks passed
senamakel pushed a commit to aqilaziz/openhuman that referenced this pull request May 23, 2026
…yhumansai#2506)

Co-authored-by: agent:skill-master <skill-master@openclaw>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

working A PR that is being worked on by the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants