Skip to content

Commit b59df67

Browse files
montfortclaude
andauthored
i18n(zh-CN): add Simplified Chinese translations for all documentation (#47)
Add complete Simplified Chinese (zh-CN) localization as the third supported language alongside English and Spanish. This includes: - 12 document templates (AILOG, ADR, AIDEC, DPIA, ETH, INC, MCARD, REQ, SBOM, SEC, TDE, TES) - 12 governance documents (AGENT-RULES, AI-GOVERNANCE-POLICY, AI-KPIS, etc.) - 5 NIST implementation guides (AI RMF + GenAI risks) - 6 user-facing docs (README, CONTRIBUTING, CODE_OF_CONDUCT, adopter guides) - Generalized CLI template resolution to support any language (not just es) - Updated language navigation links across all three languages - Updated CLAUDE.md version-bump checklist with zh-CN paths Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent dee8cc2 commit b59df67

63 files changed

Lines changed: 7622 additions & 38 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

CLAUDE.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -64,8 +64,10 @@ Run `cargo check` in `cli/` to update `Cargo.lock`.
6464
Update version references in all docs that mention version numbers:
6565
- `docs/adopters/CLI-REFERENCE.md` (EN — versioning table + example outputs)
6666
- `docs/i18n/es/adopters/CLI-REFERENCE.md` (ES — same)
67+
- `docs/i18n/zh-CN/adopters/CLI-REFERENCE.md` (zh-CN — same)
6768
- `README.md` (versioning table)
6869
- `docs/i18n/es/README.md` (ES — versioning table)
70+
- `docs/i18n/zh-CN/README.md` (zh-CN — versioning table)
6971

7072
Update `CHANGELOG.md` (root) following [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) format:
7173
- Add a new `## CLI X.Y.Z` section at the top (below the header)
@@ -128,11 +130,12 @@ version: "X.Y.Z"
128130
Update version references in docs:
129131
- `docs/adopters/CLI-REFERENCE.md` (EN — versioning table)
130132
- `docs/i18n/es/adopters/CLI-REFERENCE.md` (ES — versioning table)
131-
- `README.md` and `docs/i18n/es/README.md` (versioning tables)
132-
- `dist/.devtrail/00-governance/QUICK-REFERENCE.md` (EN + ES footer)
133-
- `dist/.devtrail/00-governance/AGENT-RULES.md` (EN + ES footer)
134-
- `dist/.devtrail/00-governance/DOCUMENTATION-POLICY.md` (EN + ES footer)
135-
- `dist/.devtrail/00-governance/C4-DIAGRAM-GUIDE.md` (EN + ES footer)
133+
- `docs/i18n/zh-CN/adopters/CLI-REFERENCE.md` (zh-CN — versioning table)
134+
- `README.md`, `docs/i18n/es/README.md`, and `docs/i18n/zh-CN/README.md` (versioning tables)
135+
- `dist/.devtrail/00-governance/QUICK-REFERENCE.md` (EN + ES + zh-CN footer)
136+
- `dist/.devtrail/00-governance/AGENT-RULES.md` (EN + ES + zh-CN footer)
137+
- `dist/.devtrail/00-governance/DOCUMENTATION-POLICY.md` (EN + ES + zh-CN footer)
138+
- `dist/.devtrail/00-governance/C4-DIAGRAM-GUIDE.md` (EN + ES + zh-CN footer)
136139

137140
Update `CHANGELOG.md` (root) following [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) format:
138141
- Add a new `## Framework X.Y.Z` section at the top (below the header)

CODE_OF_CONDUCT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Contributor Covenant Code of Conduct
22

3-
**Languages**: English | [Español](docs/i18n/es/CODE_OF_CONDUCT.md)
3+
**Languages**: English | [Español](docs/i18n/es/CODE_OF_CONDUCT.md) | [简体中文](docs/i18n/zh-CN/CODE_OF_CONDUCT.md)
44

55
## Our Pledge
66

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Thank you for your interest in contributing to DevTrail! This document provides guidelines and information for contributors.
44

5-
**Languages**: English | [Español](docs/i18n/es/CONTRIBUTING.md)
5+
**Languages**: English | [Español](docs/i18n/es/CONTRIBUTING.md) | [简体中文](docs/i18n/zh-CN/CONTRIBUTING.md)
66

77
## Table of Contents
88

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515
[Documentation](#documentation)
1616
[Contributing](#contributing)
1717

18-
**Languages**: English | [Español](docs/i18n/es/README.md)
18+
**Languages**: English | [Español](docs/i18n/es/README.md) | [简体中文](docs/i18n/zh-CN/README.md)
1919

2020
</div>
2121

cli/src/commands/new.rs

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -173,12 +173,12 @@ fn resolve_template_path(
173173
lang: &str,
174174
) -> PathBuf {
175175
let template_name = format!("TEMPLATE-{}.md", doc_type.prefix());
176-
if lang == "es" {
177-
let es_path = devtrail_dir
178-
.join("templates/i18n/es")
176+
if lang != "en" {
177+
let i18n_path = devtrail_dir
178+
.join(format!("templates/i18n/{}", lang))
179179
.join(&template_name);
180-
if es_path.exists() {
181-
return es_path;
180+
if i18n_path.exists() {
181+
return i18n_path;
182182
}
183183
}
184184
devtrail_dir.join("templates").join(&template_name)

cli/src/config.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ use std::path::Path;
55
/// DevTrail project configuration from .devtrail/config.yml
66
#[derive(Debug, Deserialize, Serialize)]
77
pub struct DevTrailConfig {
8-
/// Language setting: "en" or "es"
8+
/// Language setting: "en", "es", or "zh-CN"
99
#[serde(default = "default_language")]
1010
pub language: String,
1111
/// Complexity analysis settings

dist/.devtrail/00-governance/AGENT-RULES.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
> This document defines the rules that all AI agents must follow when working on projects under DevTrail.
44
5+
**Languages**: English | [Español](i18n/es/AGENT-RULES.md) | [简体中文](i18n/zh-CN/AGENT-RULES.md)
6+
57
---
68

79
## 1. Mandatory Identification

dist/.devtrail/00-governance/C4-DIAGRAM-GUIDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
> This guide explains how to use the C4 Model with Mermaid syntax in DevTrail documents, particularly in ADR (Architecture Decision Record) documents.
44
5-
**Languages**: English | [Español](i18n/es/C4-DIAGRAM-GUIDE.md)
5+
**Languages**: English | [Español](i18n/es/C4-DIAGRAM-GUIDE.md) | [简体中文](i18n/zh-CN/C4-DIAGRAM-GUIDE.md)
66

77
---
88

dist/.devtrail/00-governance/DOCUMENTATION-POLICY.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Documentation Policy - DevTrail
22

3+
**Languages**: English | [Español](i18n/es/DOCUMENTATION-POLICY.md) | [简体中文](i18n/zh-CN/DOCUMENTATION-POLICY.md)
4+
35
## Governance Framework
46

57
This policy aligns DevTrail documentation with **ISO/IEC 42001:2023** (vertebral standard for AI Management Systems) and operationalizes:

dist/.devtrail/00-governance/PRINCIPLES.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
> These principles guide all documentation decisions in the project.
44
5+
**Languages**: English | [Español](i18n/es/PRINCIPLES.md) | [简体中文](i18n/zh-CN/PRINCIPLES.md)
6+
57
---
68

79
## 1. Total Traceability

0 commit comments

Comments
 (0)