Skip to content

🇺🇦 Ukrainian localization of Kubernetes documentation - #48551

Open
Andygol wants to merge 1 commit into
kubernetes:mainfrom
Andygol:main-uk-wip
Open

Andygol wants to merge 1 commit into
kubernetes:mainfrom
Andygol:main-uk-wip

Conversation

@Andygol

@Andygol Andygol commented Oct 26, 2024

Copy link
Copy Markdown
Contributor

Description

As per request #45382 (comment) from @sftim I provide this huge PR with Ukrainian localization of the Kubernetes.

This PR contains a complete translation of all Kubernetes documentation materials as of now (Saturday, October 26, 2024)

I hope that the adoption of this PR allows us to further expand the spread of new technologies around the world.

Issue

Closes: #

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. area/localization General issues or PRs related to localization labels Oct 26, 2024
@k8s-ci-robot k8s-ci-robot added language/en Issues or PRs related to English language language/uk Issues or PRs related to Ukrainian language sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Oct 26, 2024
@netlify

netlify Bot commented Oct 26, 2024 •

Copy link
Copy Markdown

✅ Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 0851086
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/69aecbb617cd7e0008b4e332
😎 Deploy Preview https://deploy-preview-48551--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@sftim

sftim commented Oct 26, 2024

Copy link
Copy Markdown
Contributor

/hold

This PR is too large to review, but it is still really useful: other contributors can carve out smaller reviewable PRs, and get those merged one by one.

@k8s-ci-robot k8s-ci-robot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Oct 26, 2024
@sftim

sftim commented Oct 26, 2024

Copy link
Copy Markdown
Contributor

Because there's a lot of valuable work in here:
/lifecycle frozen

We should only close this if / when we are sure we no longer want to keep it around.

@k8s-ci-robot

Copy link
Copy Markdown
Contributor

@sftim: The lifecycle/frozen label cannot be applied to Pull Requests.

Details

In response to this:

Because there's a lot of valuable work in here:
/lifecycle frozen

We should only close this if / when we are sure we no longer want to keep it around.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@k8s-ci-robot k8s-ci-robot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Oct 27, 2024
@k8s-ci-robot k8s-ci-robot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Oct 28, 2024
@Andygol

Andygol commented Oct 28, 2024

Copy link
Copy Markdown
Contributor Author

@sftim thanks for helping 🙏.

I would like to ask, how do you estimate how much time it will take with the current workflow to accept the entire Ukrainian translation?

@sftim

sftim commented Oct 29, 2024

Copy link
Copy Markdown
Contributor

It's hard to estimate because the situation may change. At the current rate: maybe 5 years. However before then, more contributors may arrive.

@Andygol

Andygol commented Oct 29, 2024

Copy link
Copy Markdown
Contributor Author

At the current rate: maybe 5 years. However before then, more contributors may arrive.

Perhaps the move toward implementing a system of support and work with translations (#45756) will help speed up the process?

@sftim

sftim commented Oct 29, 2024

Copy link
Copy Markdown
Contributor

Perhaps the move toward implementing a system of support and work with translations (#45756) will help speed up the process?

It's unlikely to directly help, even if that improvement would be really lovely to have. What needs to change is the number of people willing to do final review for Ukrainian, and their capacity. The contribution level of work (actual localization work writing or updating pages) is not the constraint here.

@Andygol

Andygol commented Oct 29, 2024

Copy link
Copy Markdown
Contributor Author

the number of people willing to do final review

Perhaps the introduction of this system allows more people to be involved in the review and contribution process, making it easier for them to join the project.

Comment thread content/uk/README.md Resolved
Comment thread content/uk/README.md Resolved
@sftim

sftim commented Oct 31, 2024

Copy link
Copy Markdown
Contributor

Якщо ви володієте українською (та англійською), надішліть відгук на #48554

Неформальни відгук також корисни.


If you can speak Ukrainian (and English), please review #48554

Informal checking is helpful.

Comment thread content/uk/README.md Resolved
This was referenced Nov 5, 2026
@themoriarti

Copy link
Copy Markdown
Contributor

@Andygol a status update on splitting this PR (the wip branch frozen on 11-01, compared with today's main):

  • About 1,210 files are in open split PRs (1,163 in mine, 47 in yours); 280 of my split PRs are already merged.
  • 225 files are on main in a reviewed version that differs from this branch, so the branch copies are superseded.
  • 316 files are byte-identical to English. Hugo falls back to English for them, so they aren't needed.
  • 289 auto-generated reference pages (kubectl, kubernetes-api, config-api) are left out, because they are regenerated every release and would go stale. The kubeadm generated includes are the exception: the kubeadm pages can't build without them ([uk] Add kubeadm reference pages and generated includes #59097).
  • What's left is blocked on two glossary terms: [uk] Create ingress.md #58987 (ingress: ingress.md, service-protocols, 3 diagrams) and [uk] Create device.md #58960 (device: dra-api, install-use-dra, DRA driver examples).

What would help most:

  1. Reviewing [uk] Create ingress.md #58987 and [uk] Create device.md #58960 first, since they unblock the last translated pages.
  2. [uk] Add feature gates reference pages #59018 (feature gates, 491 files, one bundle): the Netlify preview build hangs until the 30-minute timeout without an error. Help from anyone who can run Hugo on it locally is welcome. [uk] Add kubeadm reference pages and generated includes #59097 (kubeadm, 149 files) is the other block that can't be split.
  3. Most split PRs are 2–3 files. @Arhell @MaxymVlasov, if you have time, reviews would help share the load.

Once the split PRs land, I'd suggest closing this PR, since it conflicts with main and is on hold anyway. I'm happy to keep it open as a reference until then if you prefer.

Signed-off-by: Andrii Holovin <Andygol@users.noreply.github.com>
@Andygol

Andygol commented Nov 7, 2026

Copy link
Copy Markdown
Contributor Author

Rebased against main to incorporate the latest changes.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/localization General issues or PRs related to localization cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. language/uk Issues or PRs related to Ukrainian language sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants