-
Notifications
You must be signed in to change notification settings - Fork 244
[Doc📝] Chinese docs are out of sync with English docs (missing pages and unfinished sections) #6914
Copy link
Copy link
Open
Labels
Difficulty level/EasyEasy ISSUEEasy ISSUEdocumentation📝Improvements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomershelp wantedExtra attention is neededExtra attention is needed
Description
Issue Type
Missing documentation
Location
The issue is in the Chinese docs tree for the website:
rocketmq-website/i18n/zh-CN/docusaurus-plugin-content-docs/current
English source docs for comparison:
rocketmq-website/docs
Description
Chinese documentation is currently not synchronized with English documentation in both structure and content.
Current findings from comparison:
- English docs have 31 pages while Chinese docs have 20 pages.
- 15 English pages are missing in Chinese.
- Some Chinese pages are still placeholder-level content.
- Some existing Chinese pages are significantly less complete than their English counterparts.
Suggested Fix
Proposed phased plan:
- Create the missing zh-CN pages with correct structure/frontmatter.
- Replace placeholder pages with real translated content.
- Expand shortened pages to match English scope (especially getting-started, consumer, producer, configuration, faq).
- Add a docs sync checklist for future updates to reduce drift.
Definition of done:
- No placeholder text remains in zh-CN docs.
- Core user-facing doc structure is aligned between English and Chinese.
- Each missing page has a corresponding zh-CN page.
- Key pages have practical parity with English (not exact line-by-line translation, but complete concepts and usage coverage).
Willing to contribute?
- I can submit a PR for this
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
Difficulty level/EasyEasy ISSUEEasy ISSUEdocumentation📝Improvements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomershelp wantedExtra attention is neededExtra attention is needed