kubernetes / kubernetes/website
Localize Kubernetes website into Arabic
- 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 Arabic localization.
**What would you like to be added**
Hope to add the first live version of Arabic localization for k8s.io
This issue is to (re)initiate Arabic 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 Arabic**
- ref: https://kubernetes.io/docs/contribute/localization/#start-a-new-localization
- the language code for Arabic: `ar`
- [x] **2. Add a slack channel for Arabic**
- https://kubernetes.io/docs/contribute/localization/#find-community
- slack channel for Arabic: `#kubernetes-docs-ar`
- [x] **3. Add a label for Arabic**
- https://kubernetes.io/docs/contribute/localization/#configure-the-workflow
- label for Arabic: 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/ar.md
- [x] **5. Invite candidates for `@kubernetes/sig-docs-ar-owners` and `@kubernetes/sig-docs-ar-reviews`**
- https://kubernetes.io/docs/contribute/localization/#add-your-localization-team-in-github
- current reviewers: @mboukhalfa, @adowair, @seifrajhi
- current approvers: @mboukhalfa, @adowair, @seifrajhi
- current team members: @mboukhalfa, @seifrajhi, @adowair, @essamgouda97, @AbdelatifAitBara
- [x] **6. Check the all candidates are the member of the Kubernetes GitHub organization**
- https://kubernetes.io/docs/contribute/localization/#join-the-kubernetes-github-organization
---
- [x] **7. Add a development branch for Arabic 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
- Dev branch: `dev-1.29-ar.1` https://github.com/kubernetes/website/tree/dev-1.29-ar.1
- [x] **8. Open a PR to configure a localization environment**
- **Note**: base and target branches of the PR should be the dev branch of AR.
- [x] Add a configuration block for the new language to hugo.toml
- https://kubernetes.io/docs/contribute/localization/#modify-the-site-configuration
- [x] Add a new localization directory
- https://kubernetes.io/docs/contribute/localization/#add-a-new-localization-directory
- [x] Add and localize site strings in i18n
- https://kubernetes.io/docs/contribute/localization/#site-strings-in-i18n
- [x] Set up the OWNERS files based on the candidate list
- https://kubernetes.io/docs/contribute/localization/#set-up-the-owners-files
- [x] 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://github.com/kubernetes/website/issues/37546
- 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 AR.
~~**Note**: at this moment, candidates for Arabic reviewers and approvers do not have an authority yet. However reviews on localized contents from the candidates are required. Use `/lgtm` to express a PR is ready to be merged.~~
- [ ] **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 ar
Contributor guide
Research direction
Start with the localization guide and the dev-1.29-ar.1 branch, then inspect hugo.toml, the Arabic localization directory, i18n, and OWNERS files. Complete the minimum-required contents and localized README, run the documented build and site-preview checks, and finish by opening the PR to merge the development branch into the launch target.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- kubernetes
- Domain
- documentation, internationalization, localization
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 25/100