Umbrella issue: Localizing the Kubernetes website into Russian

[kirkonru]

Kubernetes documentation - the Russian localization project

Maintainers:

• shurup
• kirkonru

This Issue tracks the progress of the localization of the Kubernetes documentation in Russian.

General workflow

• Choose the article you want to translate from the list below and comment in this issue that you are ready to work on it.
• Wait for a response from the localization team. Maintainers will assign the chosen file to you.
• Fork the main branch of the kubernetes/website repo.
• Translate the chosen English article.
• In your fork, create a corresponding Russian file (in /content/ru/docs/…) for the article you have translated. Make sure its name is the same as the original.
• Fill it with the translated text; keep the layout and code samples intact. Use single backticks (`) to call out code or a command within a sentence.
• Create a PR named [ru] Localization of /your/article.md, add the language/ru label to it.

Points to remember

• Please use the word localization instead of translation.
• Make sure no one is translating the file.
• If you feel that the localization team takes too long to respond, feel free to @mention/ping the maintainers mentioned above.

Useful links

• For more information on how to contribute, check out these guidelines.
• Feel free to join the relevant Slack channels:
  • Kubernetes;
  • kubernetes-docs-ru;
  • sig-docs-localizations.
• Kubernetes Website Repository: https://github.com/kubernetes/website
• Russian Localization Team in Telegram - the fastest way to get in touch

Files

🟣 - localization is complete, the PR is ready for merging;
🟡 - localization is in progress;
🔵 - file is ready for review;
🟢 - file has been merged.

• concepts/architecture/cgroups.md
• 🟣 concepts/architecture/cri.md
• 🟣 concepts/cluster-administration/certificates.md
• 🟢 concepts/cluster-administration/flow-control.md
• 🟢 concepts/cluster-administration/logging.md
• 🟢 concepts/cluster-administration/manage-deployment.md
• 🟢 concepts/cluster-administration/networking.md
• 🟢 concepts/cluster-administration/proxies.md
• 🟢 concepts/cluster-administration/system-metrics.md
• 🟢 concepts/cluster-administration/system-traces.md
• 🟢 concepts/cluster-administration/system-logs.md
• 🟢 concepts/configuration/_index.md
• 🟢 concepts/configuration/configmap.md
• 🟢 concepts/configuration/manage-resources-containers.md
• 🟢 concepts/configuration/organize-cluster-access-kubeconfig.md
• 🟢 concepts/configuration/overview.md
• 🟢 concepts/configuration/secret.md
• 🟢 concepts/configuration/windows-resource-management.md
• 🟢 concepts/containers/_index.md
• 🟢 concepts/containers/container-environment.md
• 🟢 concepts/containers/container-lifecycle-hooks.md
• 🟢 concepts/containers/images.md
• 🟢 concepts/containers/runtime-class.md
• 🟡 WIP concepts/extend-kubernetes/_index.md
• 🟡 WIP concepts/extend-kubernetes/operator.md
• 🟡 WIP concepts/extend-kubernetes/api-extension/_index.md
• 🟡 WIP concepts/extend-kubernetes/api-extension/apiserver-aggregation.md
• 🟡 WIP concepts/extend-kubernetes/api-extension/custom-resources.md
• 🟡 WIP concepts/extend-kubernetes/compute-storage-net/_index.md
• 🟡 WIP concepts/extend-kubernetes/compute-storage-net/device-plugins.md
• 🟡 WIP concepts/extend-kubernetes/compute-storage-net/network-plugins.md
• 🟡 WIP concepts/overview/working-with-objects/finalizers.md
• 🟡 WIP concepts/overview/working-with-objects/owners-dependents.md
• 🟡 WIP concepts/policy/_index.md
• 🟡 WIP concepts/policy/limit-range.md
• 🟡 WIP concepts/policy/node-resource-managers.md
• 🟡 WIP concepts/policy/pid-limiting.md
• 🟡 WIP concepts/policy/resource-quotas.md
• 🟢 concepts/scheduling-eviction/_index.md
• 🟢 concepts/scheduling-eviction/api-eviction.md
• 🔵 concepts/scheduling-eviction/assign-pod-node.md
• 🟡 WIP concepts/scheduling-eviction/kube-scheduler.md
• 🟡 WIP concepts/scheduling-eviction/node-pressure-eviction.md
• 🟡 WIP concepts/scheduling-eviction/pod-overhead.md
• concepts/scheduling-eviction/pod-priority-preemption.md
• concepts/scheduling-eviction/resource-bin-packing.md
• concepts/scheduling-eviction/scheduler-perf-tuning.md
• concepts/scheduling-eviction/scheduling-framework.md
• concepts/scheduling-eviction/taint-and-toleration.md
• concepts/scheduling-eviction/topology-spread-constraints.md
• concepts/security/_index.md
• concepts/security/api-server-bypass-risks.md
• concepts/security/controlling-access.md
• concepts/security/multi-tenancy.md
• concepts/security/overview.md
• concepts/security/pod-security-admission.md
• concepts/security/pod-security-policy.md
• concepts/security/pod-security-standards.md
• concepts/security/rbac-good-practices.md
• concepts/security/security-checklist.md
• concepts/security/windows-security.md
• concepts/services-networking/_index.md
• concepts/services-networking/connect-applications-service.md
• concepts/services-networking/dns-pod-service.md
• concepts/services-networking/dual-stack.md
• concepts/services-networking/endpoint-slices.md
• concepts/services-networking/ingress-controllers.md
• concepts/services-networking/ingress.md
• concepts/services-networking/network-policies.md
• concepts/services-networking/service-topology.md
• concepts/services-networking/service-traffic-policy.md
• concepts/services-networking/service.md
• concepts/services-networking/topology-aware-hints.md
• concepts/services-networking/windows-networking.md
• concepts/storage/_index.md
• concepts/storage/dynamic-provisioning.md
• concepts/storage/ephemeral-volumes.md
• concepts/storage/persistent-volumes.md
• concepts/storage/projected-volumes.md
• concepts/storage/storage-capacity.md
• concepts/storage/storage-classes.md
• concepts/storage/storage-limits.md
• concepts/storage/volume-health-monitoring.md
• concepts/storage/volume-pvc-datasource.md
• concepts/storage/volume-snapshot-classes.md
• concepts/storage/volume-snapshots.md
• concepts/storage/volumes.md
• concepts/storage/windows-storage.md
• concepts/windows/_index.md
• concepts/windows/intro.md
• concepts/windows/user-guide.md
• 🔵 concepts/workloads/_index.md (localization is being handled by @ yungserge)
• 🟡 WIP concepts/workloads/controllers/_index.md (@ yungserge)
• concepts/workloads/controllers/cron-jobs.md
• concepts/workloads/controllers/daemonset.md
• concepts/workloads/controllers/deployment.md
• concepts/workloads/controllers/job.md
• concepts/workloads/controllers/replicaset.md
• concepts/workloads/controllers/replicationcontroller.md
• concepts/workloads/controllers/statefulset.md
• concepts/workloads/controllers/ttlafterfinished.md
• concepts/workloads/pods/_index.md
• concepts/workloads/pods/disruptions.md
• concepts/workloads/pods/downward-api.md
• concepts/workloads/pods/ephemeral-containers.md
• concepts/workloads/pods/init-containers.md
• concepts/workloads/pods/pod-lifecycle.md
• concepts/workloads/pods/user-namespaces.md

[sftim]

/language ru
/area localization

[shurup]

@kirkonru thank you for summing it all up! Let's also add PRs to the documents that are translated already but not merged yet, please. E.g.:

• concepts/cluster-administration/networking.md — [ru] Add RU localization - networking.md #36467
• concepts/cluster-administration/proxies.md — [ru] Add RU localization for proxies.md #36783
  …

[shurup]

We've started with translating the missing pages; however, there are some problems with existing (already translated) pages as well.

• Update design doc reference link of PLEG #37745 revealed that concepts/_index.md (and the first pages it leads to) is significantly outdated. Since it's a starting point for many users, I'd say these pages are more important than other files we have in our current todo list;
• looking at [ru] Update garbage collection page #35187 made me realise this article has room for improvement as well (hopefully, @Zhurik will handle that — we can mark him as WIP for now).

@kirkonru, reflect these thoughts in the Files, please.

[k8s-triage-robot]

The Kubernetes project currently lacks enough contributors to adequately respond to all issues.

This bot triages un-triaged issues according to the following rules:

• After 90d of inactivity, lifecycle/stale is applied
• After 30d of inactivity since lifecycle/stale was applied, lifecycle/rotten is applied
• After 30d of inactivity since lifecycle/rotten was applied, the issue is closed

You can:

• Mark this issue as fresh with /remove-lifecycle stale
• Close this issue with /close
• Offer to help out with Issue Triage

Please send feedback to sig-contributor-experience at kubernetes/community.

/lifecycle stale

[shurup]

This issue is an ongoing effort; thus, we don't want to make it stale.

/remove-lifecycle stale

[sftim]

/triage accepted
/lifecycle frozen
/area localization

[yungserge]

Hi gents! @shurup @kirkonru
I could contribute to this issue, if help is still needed.
I could start with concepts/workloads/_index.md unless you think the docs should be localized in the order provided above. Let me know. Thanks! :)

[shurup]

Hi @yungserge! Sure, there's still a lot to be done, and your help will be much appreciated!
@kirkonru, please confirm you haven't started working on concepts/workloads/_index.md yet so Sergey can proceed with this page.

[kirkonru]

Hi @yungserge! No work has begun on concepts/workloads/_index.md, so feel free to localize it. Please let me know when you are ready to proceed - I'll label the page as a WIP. The Documentation Style Guide might come in handy (Russian version is also available, but I'm not sure how up to date it is).

[yungserge]

@kirkonru I've already started, you can label it as WIP. Thanks, the Documentation Style Guide is helpful

[yungserge]

Hey guys! @shurup @kirkonru I am ready to submit the PR but it says to "Select dev-1.25-ru.1 as the target branch." and I do not see this one in the repo. Should I just select the main branch?

[shurup]

@yungserge right, mentioning the v1.25 branch there is outdated. You can use main instead.

[yungserge]

@kirkonru I can start with the next one: concepts/workloads/controllers/_index.md

[kirkonru]

@yungserge Great! Got it assigned to you.

[yungserge]

I can start working on concepts/workloads/controllers/cron-jobs.md while waiting for feedback on #44009.

[shurup]

Hi @yungserge, that's awesome! Please feel free to keep going with the whole concepts/workloads part, as we are unaware of anyone else handling it ATM.

[yungserge]

Hi @shurup, could you take a look at #44009? I am ready to submit the next document, and I wanted to get feedback on the current PR before I do so :)

[shurup]

Hi @yungserge! I will surely do that. Sorry for the delay on my side due to a vacation and Christmas holidays. Hopefully, I'll get back to reviewing it next week.

[yungserge]

@shurup No problem, just when you get a chance. Thank you!

[catinbag]

Hi @shurup, @kirkonru 👋
I can help with translating the Pods page