kubernetes / kubernetes/website

Umbrella: Localize Kubernetes website into Traditional Chinese (zh-tw)

Open
#54,645 30 comments 8 reactions 0 assignees View on GitHub
area/localization kind/feature language/zh-tw triage/accepted
Dominant language
HTML
Stars
5.4k
Forks
15.7k
Avg merge
4d 18h
Merged PRs (30d)
204

Description

**This is a Feature Request**

Initial minimum-viable Traditional Chinese (zh-tw) localization.

**What would you like to be added**

Hope to add the first live version of Traditional Chinese localization for k8s.io

Related context:
- Existing request: https://github.com/kubernetes/website/issues/53043

This umbrella issue is to (re)initiate Traditional Chinese localization efforts based on following actionable items.

Actionable items identified from:
https://kubernetes.io/docs/contribute/localization/#start-a-new-localization

- [x] **1. Select the language code for Traditional Chinese**
- ref: https://kubernetes.io/docs/contribute/localization/#start-a-new-localization
- the language code for Traditional Chinese: `zh-tw`

- [x] **2. Add a slack channel for Traditional Chinese**
- ref: https://kubernetes.io/docs/contribute/localization/#find-community
- Slack channel: `#kubernetes-docs-zh-tw`
- PR: https://github.com/kubernetes/community/pull/8895

- [x] **3. Add a label for Traditional Chinese**
- ref: https://kubernetes.io/docs/contribute/localization/#configure-the-workflow
- label for Traditional Chinese: [language/zh-tw](https://github.com/kubernetes/website/issues?q=label%3Alanguage%2Fzh-tw)

- [x] **4. Localize the community code of conduct**
- ref: https://kubernetes.io/docs/contribute/localization/#localize-the-community-code-of-conduct
- code of conduct: https://github.com/cncf/foundation/blob/main/code-of-conduct-languages/
- Traditional Chinese Code of Conduct: https://github.com/cncf/foundation/blob/main/code-of-conduct-languages/zh-tw.md
- PR: https://github.com/cncf/foundation/pull/1325

- [ ] **5. Invite candidates for `@kubernetes/sig-docs-zh-tw-owners` and `@kubernetes/sig-docs-zh-tw-reviews`**
- ref: https://kubernetes.io/docs/contribute/localization/#add-your-localization-team-in-github

- **Note**: Seeking for Interested Contributors In Traditional Chinese localization
- Please comment below if you can help with translation and/or reviews.
- Suggested info to include: GitHub handle, availability (hrs/week), and whether you can review.

- current reviewer candidates (initial): TBD
- current approver candidates (initial): TBD
- current team members (active contributors): TBD

- [ ] **6. Check all candidates are the member of the Kubernetes GitHub organization**
- ref: https://kubernetes.io/docs/contribute/localization/#join-the-kubernetes-github-organization
- Each candidate should:
1) make at least one meaningful contribution PR (or have one in progress), then
2) file their own membership request in `kubernetes/org`
- Membership process reference:
https://github.com/kubernetes/community/blob/master/github-management/new-membership-procedure.md

- [x] **7. Add a development branch for Traditional Chinese localization**
- https://kubernetes.io/docs/contribute/localization/#source-files
- https://kubernetes.io/docs/contribute/localization/#branch-strategy
- development branch for Traditional Chinese: [dev-1.35-zh-tw.1](https://github.com/kubernetes/website/tree/dev-1.35-zh-tw.1)
- Note: members of @kubernetes/website-maintainers can create new localization branches to coordinate translation efforts.
- Note: Netlify preview needs to be configured for the dev branch

- [x] **8. Open a PR to configure a localization environment**
- **Note**: base and target branches of the PR should be the zh-tw dev branch.
- Note: A PR has been merged: https://github.com/kubernetes/website/pull/54785
- Tasks:
- [x] Add a configuration block for the new language to `hugo.toml`
- ref: https://kubernetes.io/docs/contribute/localization/#modify-the-site-configuration
- [x] Add a new localization directory: `content/zh-tw/`
- ref: https://kubernetes.io/docs/contribute/localization/#add-a-new-localization-directory
- [x] Add and localize site strings in i18n: `i18n/zh-tw/zh-tw.toml`
- ref: https://kubernetes.io/docs/contribute/localization/#site-strings-in-i18n
- [x] Set up the OWNERS files based on the candidate list
- ref: https://kubernetes.io/docs/contribute/localization/#set-up-the-owners-files
- [x] Check build tests and Netlify preview

- [ ] **9. Open PRs to localize all minimum-required-contents and a localized README file**
- Minimum required content ref: https://kubernetes.io/docs/contribute/localization/#minimum-required-content
- Localized README ref: https://kubernetes.io/docs/contribute/localization/#add-a-localized-readme-file
- **Note**: base and target branches of the PR should be the dev branch of zh-tw.

- Tracking issues/PRs (add links as they open):
- [X] Home: https://github.com/kubernetes/website/pull/54922
- [ ] Setup: https://github.com/kubernetes/website/issues/55006
- [ ] Tutorials: https://github.com/kubernetes/website/issues/55046
- [X] Releases: https://github.com/kubernetes/website/pull/54911
- [ ] i18n strings:
- [x] README-zh-tw: https://github.com/kubernetes/website/pull/54785

- [ ] **10. Launch zh-tw localization (merge dev branch)**
- ref: https://kubernetes.io/docs/contribute/localization/#launch-your-new-localization
- Open a PR to merge the zh-tw dev branch into the corresponding source branch.
- [ ] Check build tests and Netlify preview of the PR.

@seokho-son FYI we’re organizing zh-tw localization execution and following the Arabic/Farsi initiation tracking format. We’re also recruiting contributors; any pointers to the right process or contacts would be appreciated.

Contributor guide

Open the contributing guide

Research direction

Start with the localization guide linked in the issue and review the outstanding checklist items, especially the zh-tw development branch. Read hugo.toml, content/zh-tw/, and i18n/zh-tw/zh-tw.toml, then inspect the linked setup, tutorials, and home or release work. Done requires completing the minimum required content and README, validating the build and preview, and merging the development branch.

Written by the indexing model from the issue text.

Assessment

Tech stack
kubernetes
Domain
documentation, localization
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.