fb896507d7
Co-authored-by: Seokho Son <shsongist@gmail.com> |
||
|---|---|---|
| .. | ||
| README.md | ||
README.md
Localization Subproject
The Kubernetes Localization Subproject is owned by SIG Docs and run by the Subproject leads.
The Kubernetes documentation is localized into many different languages. Each localization is owned by a team of contributors that specialize in translating (localizing) the Kubernetes docs into a specific language. A localization team is a self-sufficient community responsible for prioritizing work, translating content, and reviewing and merging PRs into the kubernetes/website repo for their localization.
The Localization Subproject's aim is to provide a place for localization teams to share ideas and standardize processes across all localizations. This page covers documentation, processes, and roles for the Kubernetes localization teams and the Localization Subproject.
Meetings
Regular Localization Meeting: The first Monday of the month at 15:00 UTC. Convert it to your timezone
A localization team may also hold language specific meetings. If you are interested in attending a language specific meeting see the Localization Teams section for details on how to contact each localization team.
Subproject Leadership
- Subproject leads:
- Emeritus leads: Brad Topol
Contact
- Slack: #sig-docs-localizations (Each localization team also has a language specific channel, noted below).
- Mailing list: https://groups.google.com/g/kubernetes-sig-docs-localization
Responsibilities
The Localization Subproject lead is responsible for
- Leading Subproject meetings and taking notes.
- Driving collaborative discussions and decisions around localization processes and standards.
- Ensuring the communication of localization and SIG Docs policy changes to localization teams.
- Advocating for localization-friendly practices within SIG Docs and the broader Kubernetes community.
- Helping localization teams understand SIG Docs processes, especially when languages are starting out.
- Making sure that Localization process documentation is kept up to date.
The Localization Subproject lead is not responsible for
- Running localization efforts for a language.
- Dictating how localization teams do work or organize.
- Making decisions for localizations policies or teams without the localization team's input.
Skills and Experience Required
- Familiar with the localization processes.
- Have strong written and verbal communication skills.
- A working knowledge of GitHub.
- A working knowledge of kubernetes/website review and merge processes.
Time commitment for a Localization lead is 1-2 hours per week.
Localization teams
The following is a list of all localization teams. Localization teams are responsible for keeping this list up-to-date.
"In progress" teams have started localization work, but are not yet live on the Kubernetes site.
Localization team structure
Anyone can start a new localization effort for any language or join an ongoing localization team. If you are interested in learning more about specific localization requirements or processes, see the Localization Contributing Guide.
Localization teams are self-sufficient communities within SIG Docs and are responsible for
- Localizing content on kubernetes.io into their chosen language.
- Timely reviews and merging PRs for their languages according to the review and merge processes of the kubernetes/website repo.
- Building a community that can support their localization efforts. Note that you need at least two contributors to begin a localization team because contributors can't approve their pull requests. You will likely need more contributors, reviewers, and approvers to create a sustainable localization effort.
- Organizing and prioritizing work to localize content.
- Understanding and following the Kubernetes Code of Conduct within their teams. Questions or concerns around Code of Conduct violations should be raised to the SIG Docs, Localization Subproject leadership, or Kubernetes Code of Conduct Committee.
The Localization Subproject leads and the SIG Docs leadership are always available to help localization teams by answering questions and providing feedback.
Localization team leads
A leader of a localization team is someone who is responsible for helping to guide the localization efforts for a given language. Its recommended that each localization team has at least 2 leads.
Some recommended skills for localization leads include,
- Excellent written and verbal skills in the given language.
- Experience with the kubernetes/website repo localization branching strategy.
- Experience reviewing English language PRs to develop an understanding the review processes and repo structure. It is recommended that leaders participate in the SIG Docs PR Wrangler Shadow Program.
Localization processes
See the Localization Contributing Guide for full information on localization processes and policies. This page includes information on starting a new localization, branching strategies for localizing content, and more.