Skip to content

docs: expand zh-Hans documentation coverage to match the current English docs tree #1602

@Xunzhuo

Description

@Xunzhuo

Describe the feature

Expand and organize the Simplified Chinese docs coverage so zh-Hans stops lagging far behind the current English docs tree.

Primary docs surfaces:

  • website/docs/**
  • website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/**
  • website/i18n/README.md

Primary layer

global level

Why this layer?

This is a documentation/i18n maintenance task across the website docs tree rather than a single signal/plugin/runtime feature.

Why do you need this feature?

The current repo state shows a large English/Chinese documentation gap:

  • website/docs currently has 103 Markdown docs
  • website/i18n/zh-Hans/docusaurus-plugin-content-docs/current currently has 23 Markdown docs
  • representative missing Chinese docs include:
    • intro.md
    • installation/configuration.md
    • installation/installation.md
    • overview/semantic-router-overview.md
    • overview/signal-driven-decisions.md
    • multiple fleet-sim/** pages

The repo already has a documented i18n workflow in website/i18n/README.md and locale-specific site commands in website/package.json, but there is currently no dedicated GitHub issue tracking the missing zh-Hans coverage.

Additional context

Suggested acceptance criteria:

  • the most user-facing English docs sections have corresponding zh-Hans pages under the current docs tree
  • translated files include the required translation frontmatter documented in website/i18n/README.md
  • contributors can work section-by-section without inventing a separate i18n workflow
  • docs changes validate through the normal website/docs checks used by the repository

A reasonable phased approach is:

  1. intro + installation
  2. overview
  3. tutorials
  4. fleet-sim / training / proposals

This is a good help wanted docs issue. It is intentionally larger than a typo fix, so it should be split into section-sized PRs rather than treated as a one-shot newcomer task.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/docsdocumentationImprovements or additions to documentationhelp wantedExtra attention is neededpriority/P2Nice-to-Have / Exploratory

    Type

    No type

    Projects

    Status

    Backlog

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions