RFC: Qwen Code Documentation Internationalization

[pomelo-nwu]

Summary

This RFC proposes a comprehensive internationalization strategy for Qwen Code documentation, establishing a separate repository with automated AI-powered translation workflows and a multilingual documentation site using Nextra 4.x framework.

Motivation

The Qwen Code project currently lacks internationalized documentation, limiting accessibility for non-English speaking developers. This proposal aims to:

1. Expand Global Reach: Make Qwen Code accessible to developers worldwide
2. Automate Translation: Leverage Qwen Code's AI capabilities for efficient, consistent translations
3. Maintain Quality: Establish workflows for translation validation and human review
4. Enable Community Contribution: Create a framework for community-driven localization

Detailed Design

1. Repository Structure

New Repository: qwen-code-docs

• Fork from main qwen-code repository
• Extract and retain only /docs directory
• Serve as the canonical source for all documentation

Directory Layout:

qwen-code-docs/
├── docs/                      # English baseline (canonical)
├── docs-zh/                   # Chinese translations
├── docs-de/                   # German translations
├── docs-fr/                   # French translations
├── docs-ru/                   # Russian translations
├── docs-ja/                   # Japanese translations
├── translation/               # Automation tools
│   ├── src/
│   │   ├── translator.js      # Core translation logic
│   │   ├── validator.js       # Quality validation
│   │   ├── sync.js           # Source synchronization
│   │   └── utils/
│   ├── config/
│   │   ├── languages.yaml    # Language configurations
│   │   ├── glossary.json     # Technical terminology
│   │   └── prompts/          # Translation prompt templates
│   └── workflows/            # GitHub Actions
├── site/                     # Nextra documentation site
│   ├── pages/
│   ├── components/
│   ├── theme.config.tsx
│   └── nextra.config.js
└── scripts/                  # Maintenance scripts

2. Translation Automation System

Core Components

Translation Engine (translation/src/translator.js)

• Integrates with Qwen Code AI capabilities
• Batch processing for efficiency
• Context-aware translation with technical glossary
• Markdown format preservation
• Link and code block handling

Quality Validation (translation/src/validator.js)

• Translation completeness checks
• Format validation (markdown syntax)
• Link integrity verification
• Technical term consistency
• Quality scoring based on predefined metrics

Source Synchronization (translation/src/sync.js)

• Monitors upstream qwen-code repository changes
• Identifies modified/new documentation files
• Manages version tracking and change detection
• Triggers translation workflows automatically

Translation Workflow

1. Source Monitoring: Daily check for changes in upstream repository
2. Change Detection: Identify new/modified documentation files
3. AI Translation: Process files through Qwen Code translation engine
4. Quality Validation: Automated quality checks and scoring
5. Human Review: Optional manual review for critical documents
6. Publication: Automated commit and pull request creation

3. Configuration Management

Language Configuration (translation/config/languages.yaml)

supported:
  zh:
    name: "Chinese"
    nativeName: "中文"
    code: "zh-CN"
    direction: "ltr"
  de:
    name: "German"
    nativeName: "Deutsch"
    code: "de-DE"
    direction: "ltr"
  # Additional languages...

priority: ["zh", "de", "fr", "ru", "ja"]

Technical Glossary (translation/config/glossary.json)

{
  "zh": {
    "authentication": "身份认证",
    "workflow": "工作流",
    "repository": "仓库",
    "API": "API",
    "CLI": "命令行界面"
  }
  // Additional languages...
}

Translation Settings (translation/config/translation.yaml)

api:
  maxRetries: 3
  timeout: 30000
  batchSize: 5
  rateLimitDelay: 1000

quality:
  enableValidation: true
  minScore: 0.8
  requireHumanReview: false

cache:
  enabled: true
  ttl: 86400000
  maxSize: 1000

4. Documentation Site (Nextra 4.x)

Features

• Multi-language Support: Native i18n with language switcher
• Responsive Design: Optimized for all devices
• Search: Full-text search across all languages
• Navigation: Consistent structure across language versions
• Performance: Static site generation for optimal loading

Site Configuration (site/nextra.config.js)

module.exports = {
  i18n: {
    locales: ["en", "zh", "de", "fr", "ru", "ja"],
    defaultLocale: "en",
  },
};

5. GitHub Actions Automation

Auto-Translation Workflow (.github/workflows/translate.yml)

• Trigger: Daily cron job + manual dispatch
• Process:
  1. Check for upstream changes
  2. Run translations for modified files
  3. Create pull requests per language
  4. Include translation metadata and quality scores

Deployment Workflow (.github/workflows/deploy.yml)

• Trigger: Main branch pushes
• Process:
  1. Build Nextra site with all languages
  2. Deploy to Vercel/Netlify
  3. Update search indices

Conclusion

This RFC establishes a comprehensive framework for internationalizing Qwen Code documentation through automated AI-powered translation, quality assurance, and community collaboration. The proposed solution leverages modern tooling, established workflows, and the project's own AI capabilities to create a sustainable, high-quality multilingual documentation ecosystem.

[marcelbelato]

@pomelo-nwu consider to add pt-BR, cause there are many users of Qwen CLI here in Brazil.

[pomelo-nwu]

@marcelbelato Got it—will add it in the next update.

[pomelo-nwu]

@marcelbelato Hey！this PR now includes support for Brazilian Portuguese (pt-BR), Check the docs: https://qwenlm.github.io/qwen-code-docs/pt-BR/features/subagents/

[marcelbelato]

@pomelo-nwu hey buddy! Thank u so much! I appreciate that.