kubernetes / kubernetes/website
Localize Kubernetes website into Farsi
- 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 Farsi (Persian) localization.
Hope to add the first live version of Farsi localization for k8s.io
This issue is to (re)initiate Farsi 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 Farsi**
- ref:https://kubernetes.io/docs/contribute/localization/#start-a-new-localization
- the language code for Farsi: `fa`
- [x] **2. Add a slack channel for Farsi**
- https://kubernetes.io/docs/contribute/localization/#find-community
- Slack channel for Farsi : #kubernetes-docs-fa
- [x] **3. Add a label for Farsi**
- https://kubernetes.io/docs/contribute/localization/#configure-the-workflow
label for Farsi: [language/fa](https://github.com/kubernetes/website/labels/language%2Far)
- [x] **4. Localize the community code of conduct**
- 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/fa.md
- [x] **5. Invite candidates for @kubernetes/sig-docs-fa-owners and @kubernetes/sig-docs-fa-reviews**
- https://kubernetes.io/docs/contribute/localization/#add-your-localization-team-in-github
- **Note**: Seeking for Interested Contributors In Farsi localization
- current reviewers: @SamanKhalife
- current approvers: @SamanKhalife
- current team members: @SamanKhalife
- [ ] **6. Check the all candidates are the member of the Kubernetes GitHub organization**
- https://kubernetes.io/docs/contribute/localization/#join-the-kubernetes-github-organization
- [ ] **7. Add a development branch for Farsi localization**
- https://kubernetes.io/docs/contribute/localization/#source-files
- https://kubernetes.io/docs/contribute/localization/#branch-strategy
- 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
- [ ] **8. Open a PR to configure a localization environment**
- **Note**: base and target branches of the PR should be the dev branch of FA.
- [ ] Add a configuration block for the new language to hugo.toml
- https://kubernetes.io/docs/contribute/localization/#modify-the-site-configuration
- [ ] Add a new localization directory
- https://kubernetes.io/docs/contribute/localization/#add-a-new-localization-directory
- [ ] Add and localize site strings in i18n
- https://kubernetes.io/docs/contribute/localization/#site-strings-in-i18n
- [ ] Set up the OWNERS files based on the candidate list
- https://kubernetes.io/docs/contribute/localization/#set-up-the-owners-files
- [ ] Check build test and site-preview of the PR
- [ ] **9. Open PRs to localize all minimum-required-contents and a localized README file**
- https://kubernetes.io/docs/contribute/localization/#minimum-required-content
- 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 FA.
- [ ] **10. Open a PR to merge the dev branch into**
- https://kubernetes.io/docs/contribute/localization/#launch-your-new-localization
- [ ] Check build test and site-preview of the PR
/language fa
Contributor guide
Research direction
Start with the localization guide sections linked in the issue, then inspect hugo.toml, the localization directory, i18n site strings, and the OWNERS files used by existing languages. Coordinate the FA development branch and Netlify preview, and run the build test and site preview checks for the configuration PR. Done means the minimum required content and README are localized and the dev branch is ready to merge into the live site.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- hugo
- Domain
- documentation, internationalization, localization
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100