Skip to content

docs: sync zh-CN translation with English - #371

Merged
ravindu644 merged 1 commit into
mainfrom
dev
Oct 24, 2026
Merged

ravindu644 merged 1 commit into
mainfrom
dev

Conversation

@ravindu644

Copy link
Copy Markdown
Owner

@404-GCross, could you review this? You maintain the Simplified Chinese docs (17fddc1), and this pass changes a fair amount of your translation.

What was wrong

  • Documentation/zh-CN/README.md linked every doc as ../X.md, which is the English folder, so tapping a link in the Chinese README opened the English page. It now points at the zh-CN siblings.
  • The pages had drifted from English, partly because some were translated from older English text.

What changed

Every zh-CN page was compared with its English source section by section. Existing wording was kept wherever it was already correct.

  • CONTRIBUTING:
    • component tables updated for the config-screen rebuild;
    • runit added;
    • the removed ds_fix_host_ptys row dropped;
    • the missing "header line" column restored in the C logging table.
  • Anland: rewritten to follow the current English guide:
    • only Anland 5.x is supported;
    • the --anland CLI line is back;
    • turning on Anland display turns off Termux:X11;
    • the footer is restored.
  • Networking-From-Zero:
    • added the Linux route monitor and the bridge MAC note;
    • added the Macvlan column in the comparison table;
    • rewrote both --upstream use cases;
    • fixed ds-v to ds-c in the diagram.
  • Features, Linux-CLI, Kernel-Configuration: added the swap limit (--allow-swap, CONFIG_MEMCG_SWAP).
  • Features, Usage-Android-App: added runit and the --json rename.
  • community-supported-devices:
    • RM6785 link moved to v1.0, with a source link;
    • added the missing contribution rule and footer;
    • fixed the note on none.
  • Smaller fixes:
    • "Allow Sandboxing" now uses the app's own label 允许沙箱, replacing 允许用户命名空间;
    • stale titles and descriptions corrected;
    • em-dashes removed, per the repo style rules.

Graphics-and-Audio, Troubleshooting and Installation-Linux needed no changes.

Please check

  • The wording of the new and rewritten paragraphs, especially Anland and the --upstream section of Networking-From-Zero.
  • The toggle names, which now follow the app's zh-rCN strings.

Commands, flags and paths in code blocks match English byte for byte. Only translated comments and diagram labels differ.

🤖 Generated with Claude Code

@404-GCross

Copy link
Copy Markdown
Contributor

Got it, let me check.

@ravindu644

Copy link
Copy Markdown
Owner Author

Got it, let me check.

Okayy

@404-GCross 404-GCross left a comment

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.

I checked this against the English source. The structure lines up (headings, code fences, links, anchors, front matter), and the new coverage for --allow-swap, runit and --json is correct. CI is green. Three things to fix before merge:

  1. Documentation/zh-CN/README.md: this reverts the deliberate wording Droidspaces 是一个特权容器。 to …特权容器运行时。. Please keep 特权容器; it was changed on purpose earlier.

  2. Documentation/zh-CN/Anland.md: the three new labels end with a full stop inside the bold run:

    • **支持 Droidspaces 的 Android 设备。**
    • **打过 Anland 补丁的合成器后端。**
    • **兼容的 GPU。**
      The rest of the Chinese docs use a colon after label openers (**……:**). Please switch these three to colons.
  3. Documentation/zh-CN/Cool-things-you-can-do.md: ssh alice@<容器名> should stay ssh alice@<container name>; placeholders inside backticks are not translated.

Optional, non-blocking:

  • Features.md: keeping <a id="sandboxing"> and <a id="hardware-access-mode"> would preserve external deep links; nothing internal depends on them now.
  • Installation-Android.md: removing the bold from Root 管理器 and 运行时间 is inconsistent with the other pages.
  • Uninstallation.md: root 管理器 -> Root 管理器 (the app's label).
  • Networking-From-Zero.md: "Droidspaces 运行一个小型的给每个容器开放的 DHCP 服务器" reads awkwardly; "在每个容器的宿主机侧 veth 上运行一个小型 DHCP 服务器" is clearer.

The rewritten --upstream section and the Macvlan table read well.

The Chinese README linked every doc as ../X.md, which is the English
folder, so readers landed on English pages. Point them at the zh-CN
siblings.

The last translation pass was made from older English text, so the
pages had drifted beyond the recent commits. Compare every page with its
English source and bring it level: the CONTRIBUTING component tables
from the config-screen rebuild, the current Anland guide, the Linux
route monitor and Macvlan column in Networking-From-Zero, the swap limit
in Features, Linux-CLI and Kernel-Configuration, runit, the --json
rename, and the RM6785 kernel link. Use the app's own label for Allow
Sandboxing (允许沙箱) and drop em-dashes.

Commands, flags and paths in code blocks now match English byte for
byte; only translated comments and diagram labels differ.

Signed-off-by: ravindu644 <droidcasts@protonmail.com>
@ravindu644

Copy link
Copy Markdown
Owner Author

I've updated the docs according to your recommendations. waiting for your review.

@404-GCross

404-GCross commented Oct 24, 2026 •

Copy link
Copy Markdown
Contributor

Checked,no issues found

@ravindu644
ravindu644 merged commit 9cc9565 into main Oct 24, 2026
2 checks passed
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.

2 participants