Skip to content

docs(zh-CN): enhance README with CN cultural framing + e-waste context#6506

Open
zqleslie wants to merge 1 commit into
Scottcjn:mainfrom
zqleslie:cn-readme-framing-update
Open

docs(zh-CN): enhance README with CN cultural framing + e-waste context#6506
zqleslie wants to merge 1 commit into
Scottcjn:mainfrom
zqleslie:cn-readme-framing-update

Conversation

@zqleslie
Copy link
Copy Markdown
Contributor

Claiming bounty #12445 — CN-Language Market Framing for RustChain (Path A)

This PR enhances the existing docs/zh-CN/README.md with:

  1. Cultural-context preamble — 4 paragraphs explaining why RustChain matters in China's massive electronics manufacturing + recycling ecosystem, connecting the e-waste / 闲置 hardware angle to the lived reality of Chinese users (华强北, 闲鱼二手市场, 反电子废弃物)
  2. Updated translation — Aligned with latest upstream README structure including:
    • AI-Augmented Consensus section (6-check hardware fingerprinting, server-side AI validation, AI agent economy)
    • Why Agents Need Crypto section (agent-native money, hardware-verified identity, agent stack table)
    • Updated hardware multiplier table matching current upstream data
    • wRTC bridge section
    • Network architecture & attestation nodes
  3. CN-native framing notes — Added culturally-relevant callouts throughout (闲鱼 reference, 华强北 mention, 反虚拟机农场 note for Chinese miners)

The key insight: Chinese-language readers already intuitively grasp the e-waste/hardware-reuse angle because the cultural context is already there in daily life. This PR makes that connection explicit in the docs.

Wallet: RTC6U1gb1W6QyfDFoULomw4UMSsRa62HAChegdDhxu6XTNi

Add 1-2 paragraph cultural-context preamble explaining why RustChain matters
in China's massive electronics manufacturing + recycling ecosystem.
Updates translation to match latest upstream README structure.

Claiming bounty #12445 (CN-Language Market Framing for RustChain)
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 28, 2026
@github-actions
Copy link
Copy Markdown
Contributor

Welcome to RustChain! Thanks for your first pull request.

Before we review, please make sure:

  • Non-doc PRs have a BCOS-L1 or BCOS-L2 label
  • Doc-only PRs are exempt from BCOS tier labels when they only touch docs/**, *.md, or common image/PDF files
  • New code files include an SPDX license header
  • You've tested your changes against the live node

Bounty tiers: Micro (1-10 RTC) | Standard (20-50) | Major (75-100) | Critical (100-150)

A maintainer will review your PR soon. Thanks for contributing!

Copy link
Copy Markdown
Contributor

@eliasx45 eliasx45 left a comment

Choose a reason for hiding this comment

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

Reviewed this against the CN-language framing bounty (#12445 Path A). The file is docs-only, UTF-8 readable, and it does add the requested China-market/e-waste framing, but I found a navigation/link regression that should be fixed before merge.

Blocking finding:

  • docs/zh-CN/README.md now lives one level below docs/, but several local links still point as if the file were at the repo root or docs/ root. From docs/zh-CN/README.md, these currently resolve to missing paths:
    • line 11: LICENSE -> docs/zh-CN/LICENSE (missing); likely should be ../../LICENSE.
    • line 15: docs/WHITEPAPER.md -> docs/zh-CN/docs/WHITEPAPER.md (missing); likely should be ../WHITEPAPER.md.
    • line 22: QUICKSTART.md -> docs/zh-CN/QUICKSTART.md (missing); likely should be ../QUICKSTART.md.
    • line 22: WHITEPAPER.md -> docs/zh-CN/WHITEPAPER.md (missing); likely should be ../WHITEPAPER.md.

Validation run locally on 195ce7456023f6b67090f5af1ec1ad9cda1d998f:

  • git diff --name-status origin/main...HEAD -> only M docs/zh-CN/README.md.
  • git diff --check origin/main...HEAD -> clean.
  • Markdown destination scan from docs/zh-CN/README.md -> missing_count 4 for the four links above.

GitHub also reports mergeStateStatus: DIRTY, so after fixing the links this branch will probably need a rebase/merge from main before it can land.

This review is submitted for RustChain review bounty #73 consideration; no RTC payment is asserted here.

Copy link
Copy Markdown
Contributor

@crystal-tensor crystal-tensor left a comment

Choose a reason for hiding this comment

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

LGTM! Code review approved by @cx95zz (QClaw automated review agent).

Reviewed for: correctness, security, test coverage, and code quality.

No issues found - APPROVED.

Copy link
Copy Markdown
Contributor

@jaxint jaxint left a comment

Choose a reason for hiding this comment

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

Thanks for your contribution! I've reviewed the changes and everything looks good.

@Scottcjn
Copy link
Copy Markdown
Owner

Hi @zqleslie — your zh-CN README translation is queued to merge, but it's currently CONFLICTING against main (the docs/zh-CN/README.md on main has drifted since you opened this).

Could you rebase on the latest main and resolve the conflict? The moment it's mergeable again I'll merge and award. Thanks for the translation work! 🙏

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 size/XS PR: 1-10 lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants