Skip to content

[FEATURE]: Translate the V2 docs into Vietnamese (vi) #56316

Closed as not planned
Closed as not planned

Description

@dat-rd

The V2 docs under services/www/src/docs/content are English-only today. #55448 adds the multi-language layer (per-locale content directories plus a docsLocaleKeys registry) and currently ships ar and br. This issue tracks adding vi.

I have the Vietnamese translation of all 61 English pages ready, and will land it in five reviewable batches instead of one large PR:

Batch Pages Lines
1 index, agents, commands, compaction, config, instructions, models, permissions, plugins, skills 2,877
2 build/ (12 pages) 5,433
3 remaining root pages (14) 3,892
4 cli/ (10) 2,547
5 console/ (15) 2,054

Every batch only adds files under content/vi/, matching the layout #55448 uses, so nothing changes until the locale key exists. Once #55448 lands, enabling Vietnamese is a one-line addition to docsLocaleKeys.

Translation notes:

  • One glossary across all 61 pages: agent → tác nhân, session → phiên, file → tệp, plugin/extension → tiện ích mở rộng, provider → nhà cung cấp, model → mô hình, prompt → lời nhắc, skill → kỹ năng, workspace → không gian làm việc. worktree stays in English, matching how the Vietnamese developer community uses it.
  • Code, CLI flags, JSON keys, file paths, product names and keyboard legends stay verbatim; only prose is translated.
  • Every page is checked against its English source for heading structure, byte-identical code fences, identical inline-code spans and link targets, table shapes, and leftover English prose.

Review from native speakers is welcome, especially for worktree, the free-model notes in the console pages, and the CLI/TUI terms.

Activity

  1. opencode-agent commented on Oct 17, 2026

    @opencode-agent
    Contributor

    Thanks for offering this and for splitting the Vietnamese V2 docs translation into reviewable batches. As I understand it, you'd add content/vi/ pages for all 61 English pages, and once the multi-language layer lands, enable them with one entry in docsLocaleKeys.

    Maintainers will consider it. One thing to know: on dev the V2 docs (services/www) are still English-only, so this depends on #55448. That PR covers the same 18 locales as opencode.ai, and Vietnamese isn't one of them yet, so adding vi would be a new locale rather than one already planned.

    Related:

  2. neriousy commented on Nov 12, 2026

    @neriousy
    Member

    Thanks! We're not taking requests for listings or new doc translations through issues right now. Closing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions