Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New Indonesian Translation Progress #330

Open
gaearon opened this issue Apr 25, 2023 · 127 comments
Open

New Indonesian Translation Progress #330

gaearon opened this issue Apr 25, 2023 · 127 comments
Labels
good first issue Good for newcomers help wanted Extra attention is needed

Comments

@gaearon
Copy link
Member

gaearon commented Apr 25, 2023

For New Translators

To translate a page:

  1. Check that no one else has claimed your page in the linked issues below.
  2. Comment on the linked issue that you would like to translate said page. Please take only one page at a time.
  3. Clone this repo, translate your page, and submit a pull request!

Before contributing, read the glossary and translation guidelines to understand how to translate various technical and React-specific terms.

Please be prompt with your translations! If you find that you can't commit anymore, let the maintainers know so they can assign the page to someone else.

For Maintainers

Make sure to link to the exact page being translated on the first comment of the issue. Ex:

Page: https://id.react.dev/learn

When PRs are created, make sure that it's linked to the correct issue! This will make sure the issue is closed automatically when the PR is merged.

This ensures your translation's progress is tracked correctly at https://translations.react.dev/.

Main Content

To do before releasing as an "official" translation. Please translate these pages first.

Note that each section has an index page, which needs to be translated too.

Learn React (High Priority)

API Reference (High Priority)

Navigation and UI (Medium Priority)

We suggest to leave most of the UI translation until the end. We plan to do some invasive changes to the website folder layout and components, so postponing this until your translation is almost complete would make it easier to merge the changes from our side later. It might make sense to translate the homepage above the fold early, but leave the rest for later. As individual pages get translated, you can change the page titles in the corresponding sidebar files. Finally, when you're translating the navigation, make sure to test both desktop and mobile layouts.

When You're Ready...

After everything above is translated, add your language to deployedLanguages in Seo.tsx of the original reactjs/react.dev repository.

Secondary Content (Medium Priority)

These API pages should ideally be translated too, but they're less urgent and can be done after the others:

Optional Content (Low Priority)

These aren't the main translation targets, but if you'd like to do them, feel free to expand the list to include their subpages:

  • Community

Maintainers

This translation is maintained by:

If you want to become a maintainer, ask them to add you. If the original maintainers are no longer responsive, raise an issue in the main translations repository.

@roniardev
Copy link

roniardev commented Apr 25, 2023

May i translate a Quick Start Page ?

@mustafamilyas
Copy link
Contributor

mustafamilyas commented Apr 25, 2023

I'm interested in translating, "describing the UI" overview page, may I?

@syauqy
Copy link
Contributor

syauqy commented Apr 25, 2023

Hi, I'm interested to translate "Installation" and "Start a New React Project" page under the Installation section.

@wd-Agung
Copy link
Contributor

I would like to translate the "Editor Setup" page under the Installation section

@rickyraz
Copy link

I'm interested in contributing, may I translate the page 'Conditional Rendering'

@padunk
Copy link
Contributor

padunk commented Apr 25, 2023

Hi, love to contribute back to React community, I would like to translate Add React to an Existing Project

@Cikang44
Copy link
Contributor

Hi, I'm interested in contributing, may I translate the "Your First Component" page

@r17x
Copy link
Collaborator

r17x commented Apr 25, 2023

Hi, I'm interested to translate react -> context react: APIs -> createContext 👍

@chrsep
Copy link
Contributor

chrsep commented Apr 25, 2023

Hi! I'd also love to contribute back to react. Can i take the Adding Interactivity overview page?

@gaearon
Copy link
Member Author

gaearon commented Apr 25, 2023

@arfianadam @gedeagas @regalius @rizafahmi @resir014 @grikomsn

Can you please confirm if you will be able to maintain and steer this translation? We need to get https://github.com/reactjs/translations.react.dev/blob/main/langs/id.json to match the current list of active maintainers. Thank you!

@kalmndo
Copy link

kalmndo commented Apr 25, 2023

I'm really loved if i can contribute on Managing State

@samnap11
Copy link
Contributor

samnap11 commented Apr 25, 2023

I would like to contribute as well by translating "Rendering Lists".

@mhaidarhanif
Copy link
Collaborator

Hi @resir014 and @grikomsn , once you've confirmed the question from @gaearon, we three @zainfathoni @r17x @mhaidarhanif also would like to be listed as well. Thank you

@resir014
Copy link
Member

resir014 commented Apr 26, 2023

Can you please confirm if you will be able to maintain and steer this translation? We need to get reactjs/translations.react.dev@main/langs/id.json to match the current list of active maintainers. Thank you!

Hi @gaearon!

Sorry for the late response, but yes, I'll be able to manage the translation for the Indonesian localisation. And as @mhaidarhanif mentioned, we can also add him, @r17x, and @zainfathoni to the maintainers list.

@resir014
Copy link
Member

resir014 commented Apr 26, 2023

May i translate a Quick Start Page ?

@infrasync Of course! Your assigned page will be: Quick Start

As for me, I'll take the other one: Tutorial: Tic Tac Toe and Thinking in React.

@resir014 resir014 added good first issue Good for newcomers help wanted Extra attention is needed labels Apr 26, 2023
@resir014
Copy link
Member

I'm interested in translating, "describing the UI" overview page, may I?

@mustafamilyas Of course!

Your next page will be: Describing the UI

@resir014
Copy link
Member

resir014 commented Apr 26, 2023

Hi, I'm interested to translate "Installation" and "Start a New React Project" page under the Installation section.

@syauqy You got it!

Your next page(s) will be: Installation, Start a New React Project

@resir014
Copy link
Member

I would like to translate the "Editor Setup" page under the Installation section

@agprst Your next page will be: Editor Setup

@resir014
Copy link
Member

I'm interested in contributing, may I translate the page 'Conditional Rendering'

@rickyraz Your next page will be: Conditional Rendering

Hi, love to contribute back to React community, I would like to translate Add React to an Existing Project

@padunk Your next page will be: Add React to an Existing Project

Hi! I'd also love to contribute back to react. Can i take the Adding Interactivity overview page?

@chrsep Your next page will be: Adding Interactivity

I'm really loved if i can contribute on Managing State

@kalmndo Your next page will be: Managing State

I would like to contribute as well by translating "Rendering Lists".

@samnap11 Your next page will be: Rendering Lists

Thank you all!

@averrows
Copy link

Hi @resir014, I'd like to contribute to react: Hooks > useSyncExternalStore. Can you please assign it to me? thank you.

@juliansyahrifqi
Copy link

juliansyahrifqi commented Apr 28, 2023

Hello, I am interested to translate react-dom: Components > <textarea> page. Thank you

@shaddamalbz
Copy link

Hi @shaddamalbz, that page has been claimed. Would you like to claim another page?

Hi @resir014, sure, how about <StrictMode> is it have been claimed yet?

@abidra
Copy link
Contributor

abidra commented Apr 28, 2023

Hi @resir014, I'd like to contribute to react: react-dom: Components > <input>. Can you please assign it to me? thank you.

@fandok
Copy link

fandok commented Apr 28, 2023

Hi @resir014, I would like to contribute to Escape Hatches page. Can you help to assign the page to me? Thank you very much!

@stackpan
Copy link

Can i contribute to Escape Hatches > Synchronizing with Effects?

@andreepratama27
Copy link
Contributor

Hi, Can I contribute and assign me to page Escape Hatches > Removing Effect Dependencies, please?

@resir014
Copy link
Member

resir014 commented Apr 28, 2023

Hey everyone!

Thank you for your enthusiasm in this translation project. To anticipate the demand, we're currently updating the workflow of our translation project. We're converting the checklist on the original post into sub-issues so that everyone can claim them directly from said issue, rather than polluting this issue thread.

As soon as our work is done, this issue thread can be used for general discussions related to the translation project. We'll also update the relevant documentation to reflect this new workflow change.

Thanks!

@doaortu
Copy link

doaortu commented Apr 28, 2023

  1. Having all the issues ready for unfinished translations, because there are about 100 of them.

Hey @mhaidarhanif, @resir014 I can help opening those issue for you. If you guys down with that, I can start right away.

@resir014
Copy link
Member

Hey @mhaidarhanif, I can help opening those issue for you.

@doaortu The maintainers are running through all the issues one by one. You can relax for now.

@doaortu
Copy link

doaortu commented Apr 28, 2023

@doaortu The maintainers are running through all the issues one by one. You can relax for now.

Ah I see, thank you for the update.

@ical10
Copy link

ical10 commented Apr 28, 2023

Hi, I'm interested in contributing. Where can I see pages that are not assigned yet?

@mhaidarhanif
Copy link
Collaborator

@ical10 Please wait, as explained by @resir014 above, we're migrating to a better workflow so "we can see pages that are not assigned yet" much easier.

@zainfathoni
Copy link
Collaborator

zainfathoni commented Apr 28, 2023

As some of us suggested, we are mechanism to avoid unnecessary bottlenecks during the assignment process. The process is inspired by WargaBantuWarga project.

Here's the gist of the process, we will move it to the corresponding documentation soon.

Issue assignment & Communication

Once you're ready with your branch and have something to contribute, you'll want to
let everyone know that you are working on the issue. To communicate this, we
are using GitHub's Draft Pull Requests.

Draft Pull Request is like a regular Pull Request but it can't be merged until
it's marked as "ready for review". It signals other contributors that it's a
work in progress
.
This is necessary to signal other contributors that the work for the particular
issue has started and it is still in progress. Also, it is a better approach to
use as a communication tool between contributors because we can provide
additional information other than viewing the changed files.

Therefore, when you have at least one commit it's important to create a Draft
Pull Request
to let everyone know that the issue is assigned to you.

Creating a Draft Pull Request

Steps to creating a Draft Pull Request:

  1. Commit and push your new changes into the remote repository. Please refer to @commitlint/config-conventional for your commit message or you can use commitlint.io to assist you in composing the commit message.
  2. Head over to the Pull requests section on your forked repository, hit New pull request.
    Hint-1
  3. Pick your forked repository for the head repository, and compare with the branch that you are having changes in.
    Hint-2
  4. Put a clear title and description in your pull request. Make sure the
    description follows our guide below.
    Hint-3
  5. Pick Create draft pull request (like in the image above) and hit the green button.
  6. Don't forget to mark your Draft Pull Request as Ready for review after you commit all of the changes.

Formatting Pull Request Description

To properly link a pull request to an issue, there is one tiny requirement text to put in a Pull Request description.
Please make sure to mention the issue that you're working on correctly. Replace
this text <!-- mention the issue that you're trying to close with this PR -->
from the template with the issue number. Example:

Closes #318

For the moment, we lock this issue to stop the old flow (commenting in this thread asking for assignments) immediately.

@reactjs reactjs locked as resolved and limited conversation to collaborators Apr 28, 2023
@zainfathoni
Copy link
Collaborator

I updated the TRANSLATION.md page with the abovementioned mechanism. Please take a look at that new process from now on.

Thank you for contributing, and happy translating! 😄

@zainfathoni
Copy link
Collaborator

In principle, anyone available to translate any page, please raise a Draft PR at your earliest convenience.
The issue description's Assignee: @username text is a remnant of the previous assignment process.
From now on, we will prioritise any PRs (or draft PRs) as a sign of self-assignment to the particular issue.

@resir014
Copy link
Member

Hello everyone:

I'm pleased to announced that we've reached 50% progress in our Core translations! 🎉

image

With this milestone, we've also announced that we're also opening translations for the medium priority issues, starting from the Legacy React APIs section. Please check the first post for links to these issues.

Additionally, we're also opening translations for the UI elements once we got all the translated document titles figured out - since there are files like sidebar.json which relies on said translated document titles.

Thank you for your continued contribution! 💙

@resir014
Copy link
Member

resir014 commented Apr 9, 2024

We've added some new pages from the upstream version to translate:

Also there's a new "React Reference Overview" and "Rules of React section available to translate here: #649

@resir014
Copy link
Member

Wave 2 translations for id.react.dev have been opened!

In this second wave, we will translate new pages added in anticipation of the new features to be added in React 19, as well as features in Canary channel, and also React Server Components.

image

image

Please claim your issue(s) here: #681

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
good first issue Good for newcomers help wanted Extra attention is needed
Projects
None yet
Development

No branches or pull requests