Skip to content

Slim translated docs to English source plus full Chinese translation - #207

Merged
titanwings merged 2 commits into
dot-skillfrom
docs/i18n-slim
Oct 13, 2026
Merged

titanwings merged 2 commits into
dot-skillfrom
docs/i18n-slim

Conversation

@titanwings

@titanwings titanwings commented Oct 12, 2026 •

Copy link
Copy Markdown
Owner

Requested by Tianyi · project thread

Summary

Before: README existed in 8 full translations and ROADMAP in 7. All translated READMEs were missing the Personal Agents and Citation sections and three host logos, and no README linked to the translated ROADMAPs.

After: README.md is the English source. README_ZH.md stays a full translation and is back in sync. DE/ES/JA/KO/PT/RU are ~50-line landing pages (what it is, install, usage, links back to English). The translated ROADMAPs are gone, and a test fails CI when README_ZH.md falls behind.

Rebased onto dot-skill after #206, #209 and #208.

Changes

  • Rewrite docs/lang/README_{DE,ES,JA,KO,PT,RU}.md as short landing pages.
  • Add the missing 个人 Agent and 引用 sections to README_ZH.md.
  • Delete docs/lang/ROADMAP_*.md (7 files) and the language bar in ROADMAP.md.
  • Replace "reusable Skills" with "Person Profile" wording in ROADMAP.md and CONTRIBUTING.md.
  • New tests/test_translation_sync.py: README_ZH.md must keep the same ## sections, images and external links as README.md; landing pages must link back to the English README and install guide.
  • tests/test_skill_entrypoint_docs.py: only the i18n file-list assertions change (full host/quick-start contract now applies to README_ZH.md only; ROADMAP translations dropped from the lists).

No file shipped in the npm package or used by SKILL.md changes.

Testing

  • python -m unittest discover -s tests -p 'test_*.py' passes (120 tests)
  • ruff check tools/ tests/ (0.16.8) passes
  • node bin/distilly.mjs --check-package passes
  • Every relative link and image in the changed docs resolves
  • Restoring the old README_ZH.md makes test_translation_sync fail with the missing sections listed

Checklist

  • Docs updated
  • No secrets, tokens, or personal data committed
  • Tests updated

🤖 Generated with Claude Code

https://claude.ai/code/session_01JFzCaMi3X5RVxc35TCzbJ2

@titanwings titanwings self-assigned this Oct 12, 2026
…ation

- Turn the DE/ES/JA/KO/PT/RU READMEs into short landing pages that link
  back to the English README.
- Bring README_ZH.md up to date with the Personal Agents and Citation
  sections it was missing.
- Delete the seven translated ROADMAPs, which no README linked to.
- Use "Person Profile" wording in ROADMAP.md and CONTRIBUTING.md.
- Add tests/test_translation_sync.py so a section, image or link added to
  README.md fails CI until README_ZH.md catches up.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JFzCaMi3X5RVxc35TCzbJ2
…render

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JFzCaMi3X5RVxc35TCzbJ2
@titanwings
titanwings changed the base branch from cleanup/unused-files-and-installers to dot-skill October 13, 2026 05:38
@titanwings
titanwings marked this pull request as ready for review October 13, 2026 05:38
@titanwings
titanwings merged commit c307539 into dot-skill Oct 13, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants