Skip to content

[Docs] README_ZH.md links to English documents instead of available Chinese versions #7873

Description

@jaxint

Bug: README_ZH.md links to English documents, missing Chinese versions

Description

The Chinese README (README_ZH.md) contains links that point to English-only documentation files, making it difficult for Chinese-speaking users to access localized content.

Affected Links

From line 16 and lines 31-32 in README_ZH.md:

  1. [白皮书](docs/WHITEPAPER.md) - Links to English whitepaper, but there's a Chinese version available: docs/zh-CN/RustChain_Whitepaper_zh-CN_v1.0.md

  2. [wRTC快速入门](docs/wrtc.md) - No Chinese version exists

  3. [wRTC教程](docs/WRTC_ONBOARDING_TUTORIAL.md) - No Chinese version exists

Expected Behavior

  • Chinese README should link to Chinese documentation when available
  • For the whitepaper, should link to docs/zh-CN/RustChain_Whitepaper_zh-CN_v1.0.md instead of docs/WHITEPAPER.md
  • For wRTC docs, either create Chinese versions or clearly indicate they are English-only

Impact

  • Chinese users may not realize they're clicking into English documentation
  • Reduces accessibility for non-English speakers
  • The Chinese whitepaper exists but isn't being used!

Suggested Fix

  1. Update README_ZH.md line 16: Change docs/WHITEPAPER.md to docs/zh-CN/RustChain_Whitepaper_zh-CN_v1.0.md
  2. Consider creating Chinese translations for wrtc.md and WRTC_ONBOARDING_TUTORIAL.md
  3. Or add (EN) suffix to links pointing to English-only docs

Evidence

  • docs/zh-CN/ directory exists with 11 Chinese docs including the whitepaper
  • README_ZH.md has 419 lines, with English command examples (expected) but also untranslated documentation links
  • Line 16 contains three links all pointing to English docs

Severity: Low (content issue, not breaking functionality)
Priority: Medium (affects user experience for Chinese speakers)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions