Improve English prose in high-traffic handbook guides
Author: xirongCreated Jun 7, 2026Updated Jun 7, 2026
Labelsenhancementhelp wanted
Background
The handbook now has English versions for the main content. Some high-traffic guides still need one more editing pass to read like native technical writing.
Scope
Start with the entry points and core guides:
README.md05-ai-native-development/05-ai-native-development_en/ai-native-git-workflow_en.md05-ai-native-development/05-ai-native-development_en/codex-claude-code-git-practices_en.md05-ai-native-development/05-ai-native-development_en/ai-generated-code-review_en.md03-team-collaboration/03-team-collaboration_en/team-git-workflow-guide_en.md04-github-engineering/04-github-engineering_en/github-engineering-governance_en.md06-troubleshooting/06-troubleshooting_en/git-troubleshooting-playbook_en.md10-company-practices/10-company-practices_en/company-practices-decision-map_en.md
Done When
- The edited guides keep the same structure and meaning.
- Awkward literal translations are replaced with natural technical English.
- Internal links still pass
python3 scripts/check-docs.py. git diff --checkpasses.
Source: xirong/my-git