search

kubernetes / website

Kubernetes website and documentation repo:
https://kubernetes.io
Creative Commons Attribution 4.0 International
4.44k stars 14.28k forks source link

Localize Kubernetes website into Arabic #44682

Open seokho-son opened 8 months ago

seokho-son commented 8 months ago

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

/language ar

dipesh-rawat commented 8 months ago

/area localization

sftim commented 8 months ago

/retitle Localize Kubernetes website into Arabic

sftim commented 8 months ago

@seokho-son we typically ask for at least draft PRs before we'd make a localization branch. This cuts down the effort to maintain branches if it turns out that the localization team doesn't sustain the work.

sftim commented 8 months ago

(you can change the target branch of a PR after it's opened, so the draft PRs can turn into real PRs once the branch is made).

seokho-son commented 8 months ago

Note: Current Status of Arabic Localization

There is a stalled issue regarding Arabic localization, #37546. I opened this issue to assist Arabic contributors in reinitiating (or making a fresh start on) contributions, focusing solely on establishing the first live version.

Additionally, there have been several attempts by various contributors in the past, but these were neither completed nor sustained. https://github.com/kubernetes/website/pulls?q=is%3Apr+label%3Alanguage%2Far

I assume it's challenging to continue with the previous draft PRs, considering their age and the uncertainty about whether the original contributors are still willing to continue.

SIG-Docs localization subproject has recently requested assistance from some individuals to help with the initiation. I hope to use this issue to assist Arabic contributors build a team and their localization environment. I plan to invite contributors who are eager to help establish the first live version of Arabic localization and to identify potential reviewer and approver candidates.

sftim commented 8 months ago

If folk want advice on what those initial pull requests might look like, please reply here. We can link you up to people who can offer help.

seokho-son commented 8 months ago

@seokho-son we typically ask for at least draft PRs before we'd make a localization branch. This cuts down the effort to maintain branches if it turns out that the localization team doesn't sustain the work.

Hello @sftim, thank you for sharing this information. Indeed, we typically ask for at least draft PRs to the main branch before we'd make a localization branch.

While creating this issue, I looked through https://kubernetes.io/docs/contribute/localization/#start-a-new-localization and listed only the actionable tasks based on this guide. However, it seems that creating draft PRs targeting the main branch is not included in the guide. (Perhaps, updating the guide might be necessary if required.)

However, whereas creating draft PRs can help in managing dev branches, it also tends to create a slightly complex situation for teams starting their first contributions. Additionally, opening PRs targeting main can be inconvenient, as we cannot merge interim work if everything in a single PR is not perfectly completed. If there are several draft PRs (PRs to configure localization, PRs to cover minimum-required-contents, ..), contributors are hard to check preview from each PR since base localization configuration cannot be merged into the main without minimum-required-contents.

Considering that several previous attempts have also not overcome this hurdle, how about we start by creating a dev branch first this time?

sftim commented 8 months ago

/triage accepted /priority backlog

seokho-son commented 8 months ago

SIG-Docs localization subgroup leads (myself, @a-mccarthy) are going to help alongside Arabic contributors this time and complete the tasks in the issue.

Hi folks! I've compiled this list from issues and PRs related to Arabic localization. I hope you are willing to help with this (re)initiation effort for Arabic!

@adowair @mboukhalfa @mhamdisemah @mohamedsgap @nofalx @essamgouda97

Additionally, any contributors interested in helping with this issue, please let us know.

seokho-son commented 8 months ago

Please utilize the dev-1.29-ar.1 as the base branch for initiating Arabic localization.

seokho-son commented 8 months ago

Working on setting up Netlify for dev-1.29-ar.1

adowair commented 7 months ago

✅ Signing myself up to be an active contributor to this initiative. I am not yet a Kubernetes organization member.

essamgouda97 commented 7 months ago

I would like to be an active contributor for Arabic translation. I am not yet a k8s org member.

seifrajhi commented 7 months ago

Additionally, any contributors interested in helping with this issue, please let us know.

Count me in please! I'm keen to contribute to the Arabic translation efforts.

seokho-son commented 7 months ago

Hello @adowair, @essamgouda97, @seifrajhi, and @mboukhalfa (I'm awaiting @mboukhalfa's participation in this discussion. Please leave a comment below.), Thank you for your commitment to actively contributing to the Arabic team. 😊

When submitting a PR, please reference this Issue to help us effectively monitor our progress.

Also, who is interested in serving as a reviewer or an approver for Arabic? It's important to note that not all contributors are required to take on these roles, as they come with significant responsibilities. You can learn more about these roles here: Reviewers. Approvers

You can apply for both roles, but remember that the fast track is only available during the initial phase of introducing a new language. Generally, being a reviewer or an approver involves a considerable time commitment.

If you're interested in either role, please start by reviewing the Arabic content in the above PRs. Leave a comment (ex: LGTM for Arabic) if you are satisfied with Arabic content within the PR. We will consider reviewer/approver candidates based on their review and contribution activities.

seokho-son commented 7 months ago

Hi @mboukhalfa

seifrajhi commented 7 months ago

I reviewed this PR 44698 and it is now merged 🎉

adowair commented 5 months ago

Nominated Approvers and Reviewers

To achieve Step 5 above:

  1. Invite candidates for @kubernetes/sig-docs-ar-owners and @kubernetes/sig-docs-ar-reviews

From our last team meeting March 13th, 2024 (minutes):

Nominated Reviewers:

Nominated Approvers:

AbdelatifAitBara commented 4 months ago

Hi @seokho-son,

Is there anything I can help with? I am a native Arabic Speaker. Regards.

adowair commented 4 months ago

Hello @AbdelatifAitBara, thanks for joining the thread! Yes, there's a lot to help with

I see you've already joined the Slack channel. We have meetings every Wednesday at 17:00 GMT (Calendar Event, Zoom, Minutes, Recordings), and it'd be great for you to join us there to get started.

Welcome aboard!

AbdelatifAitBara commented 4 months ago

Thank you for all information @adowair :1st_place_medal:

adowair commented 4 months ago

@seokho-son I believe steps 6, 7, and 8 are now complete, so we can check them off above 😄

  1. @mboukhalfa, @seifrajhi, and @adowair are org members @essamgouda97 @AbdelatifAitBara are contributing and hope to be members soon
  2. The branch dev-1.29-ar.1 exists

  3. 44731

    44698

    45793 #45541 #45815

mboukhalfa commented 4 months ago

@seokho-son step 8 :white_check_mark: Set up the OWNERS files based on the candidate list done here https://github.com/kubernetes/website/pull/45793

seokho-son commented 4 months ago

Thanks @mboukhalfa I've checked from https://github.com/kubernetes/website/blob/dev-1.29-ar.1/OWNERS_ALIASES#L200 :)

Are there any additional reviewer or approver candidates still preparing for onboarding?

mboukhalfa commented 4 months ago

@essamgouda97 and @AbdelatifAitBara are progressing and planning to submit their membership requests soon! Our team now is pretty organized we can onboard newcomers locally and nominate the potential reviewers and approvers!

mboukhalfa commented 4 months ago

@seokho-son Can you please link this issue https://github.com/kubernetes/website/issues/37546 with the first item on step 9

adowair commented 2 weeks ago

Just checking in here: We are about 60% of the way and many of the team are out for vacations, life, events, and the like. We'll make it to complete eventually! Thanks all for everything you do

sftim commented 2 weeks ago

60% of the way

I'm surprised, because I haven't seen the number of pull requests that would suggest 60% progress.

You [Arabic team] should prioritize opening more the PRs you'll need, even if they are still draft.

sftim commented 2 weeks ago

I checked whether the dev-1.29-ar.1 branch builds; it doesn't when I try locally. Would you like any help there?