Dennis-nham · Oct 25, 2026 · Oct 25, 2026 · Oct 25, 2026 · Oct 25, 2026 · Oct 25, 2026
diff --git a/src/languages/lib/languages.ts b/src/languages/lib/languages.ts
@@ -4,7 +4,7 @@
 // Client-safe definitions avoid fs and path; server code that needs directories
 // imports languages-server.ts.
 
-export type LanguageCode = 'en' | 'es' | 'ja' | 'pt' | 'zh' | 'ru' | 'fr' | 'ko' | 'de'
+export type LanguageCode = 'en' | 'es' | 'ja' | 'pt' | 'zh' | 'ru' | 'fr' | 'ko' | 'de' | 'vi'
 export type LocaleCode =
   | 'en'
   | 'es-es'
@@ -15,6 +15,7 @@ export type LocaleCode =
   | 'fr-fr'
   | 'ko-kr'
   | 'de-de'
+  | 'vi-vn'
 
 export interface Language {
   name: string
@@ -112,6 +113,15 @@ export const languages: Languages = {
     locale: 'de-de',
     firstArchivedVersion: '3.3',
   },
+  vi: {
+    name: 'Vietnamese',
+    nativeName: 'Tiếng Việt',
+    code: 'vi',
+    hreflang: 'vi',
+    redirectPatterns: [/^\/vn/],
+    locale: 'vi-vn',
+    firstArchivedVersion: '3.12',
+  },
 }
 
 Object.freeze(languages)

diff --git a/translations/vi-vn/README.md b/translations/vi-vn/README.md
@@ -0,0 +1,51 @@
+# Bản dịch Tiếng Việt — GitHub Docs (vi-vn)
+
+Thư mục này chứa bản dịch tiếng Việt của tài liệu GitHub Docs.
+
+## Cấu trúc
+
+```
+translations/vi-vn/
+├── content/     ← Bản dịch Markdown của content/ (EN)
+└── data/        ← Bản dịch data/ variables và reusables
+```
+
+## Trạng thái dịch
+
+- **Ngôn ngữ:** Tiếng Việt (Vietnamese)
+- **Mã ngôn ngữ:** `vi`
+- **Locale:** `vi-vn`
+- **Endpoint:** `https://docs.github.com/vi`
+- **Người khởi xướng:** [@Dennis-nham](https://github.com/Dennis-nham) · NLP Labs Vietnam
+- **Tổ chức:** [@nlp-labs-vietnam](https://github.com/nlp-labs-vietnam)
+
+## Cách đóng góp
+
+1. Xem danh sách bài chưa dịch tại [GitHub Discussions](https://github.com/github/docs/discussions)
+2. Nhận bài dịch: comment vào discussion tương ứng
+3. Dịch file `.md` trong `content/` — giữ nguyên frontmatter, code block, và Liquid tags
+4. Gửi PR vào repo dịch riêng (khi GitHub tạo private translation repo cho `vi-vn`)
+
+## Quy tắc dịch thuật
+
+| Thuật ngữ EN | Tiếng Việt chuẩn |
+|---|---|
+| repository | kho lưu trữ / repository |
+| pull request | pull request (giữ nguyên) |
+| branch | nhánh |
+| commit | commit (giữ nguyên) |
+| merge | hợp nhất |
+| fork | fork (giữ nguyên) |
+| issue | vấn đề / issue |
+| workflow | quy trình làm việc |
+| action | hành động / Action |
+| release | phát hành |
+| tag | thẻ |
+| milestone | mốc quan trọng |
+| collaborator | cộng tác viên |
+
+## Liên hệ
+
+- **Email:** enterprise@nlpgroup.vn
+- **GitHub:** [@Dennis-nham](https://github.com/Dennis-nham)
+- **Org:** [@nlp-labs-vietnam](https://github.com/nlp-labs-vietnam)
diff --git a/translations/vi-vn/content/get-started/index.md b/translations/vi-vn/content/get-started/index.md
@@ -0,0 +1,19 @@
+---
+title: Bắt đầu với GitHub
+shortTitle: Bắt đầu
+intro: 'Tìm hiểu cách bắt đầu xây dựng, vận chuyển và duy trì phần mềm với {% data variables.product.prodname_dotcom %}.'
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /start-your-journey
+  - /onboarding
+  - /git-basics
+  - /using-github
+  - /writing-on-github
+  - /exploring-projects-on-github
+  - /working-with-subversion-on-github
+  - /importing-your-projects-to-github
+  - /archiving-your-work-on-github
+---
diff --git a/translations/vi-vn/content/index.md b/translations/vi-vn/content/index.md
@@ -0,0 +1,30 @@
+---
+title: 'Tài liệu trợ giúp {% data variables.product.github %}'
+featuredLinks:
+  gettingStarted:
+    - /get-started/git-basics/set-up-git
+    - /authentication/connecting-to-github-with-ssh
+    - /repositories/creating-and-managing-repositories
+    - /get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax
+  popular:
+    - /pull-requests/reference/pull-requests
+    - /authentication
+    - /copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/get-ide-code-suggestions
+    - /get-started/git-basics/managing-remote-repositories
+    - /pages
+redirect_from:
+  - /github
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - search
+  - get-started
+  - account-and-profile
+  - subscriptions-and-notifications
+  - authentication
+  - repositories
+  - admin
+  - billing
+---
diff --git a/translations/vi-vn/data/ui.yml b/translations/vi-vn/data/ui.yml
@@ -0,0 +1,37 @@
+# Chuỗi giao diện người dùng — Tiếng Việt (vi-vn)
+# Được tạo bởi: @Dennis-nham · NLP Labs Vietnam
+# Ngày: 2025
+
+header:
+  github_docs: "Tài liệu GitHub"
+  search_placeholder: "Tìm kiếm tài liệu..."
+  language_picker: "Ngôn ngữ"
+
+footer:
+  terms: "Điều khoản"
+  privacy: "Bảo mật"
+  security: "Bảo mật thông tin"
+  status: "Trạng thái"
+  docs: "Tài liệu"
+  contact: "Liên hệ"
+  manage_cookies: "Quản lý cookie"
+  do_not_share: "Không chia sẻ thông tin cá nhân"
+
+article:
+  contents: "Mục lục"
+  edit_on_github: "Chỉnh sửa trên GitHub"
+  scroll_to_top: "Lên đầu trang"
+  feedback_positive: "Bài viết có hữu ích không?"
+  feedback_yes: "Có"
+  feedback_no: "Không"
+  was_this_helpful: "Bài viết này có hữu ích không?"
+
+search:
+  label: "Tìm kiếm tài liệu"
+  results: "Kết quả tìm kiếm"
+  no_results: "Không tìm thấy kết quả cho"
+  search_again: "Tìm kiếm lại"
+
+errors:
+  page_not_found: "Không tìm thấy trang"
+  try_search: "Thử tìm kiếm để tìm nội dung bạn cần."