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 Ukrainian Translation Progress #457

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

New Ukrainian Translation Progress #457

gaearon opened this issue Apr 25, 2023 · 77 comments

Comments

@gaearon
Copy link
Member

gaearon commented Apr 25, 2023

Maintainer List

(Updated on 2024/08/23)

Active translators:

For New Translators

To translate a page:

  1. Check that no one else has claimed your page in the checklist and comments below.
  2. Comment below with the name of the page you would like to translate.
  3. Fork and clone this repo, translate your page, and submit a pull request back here!
Please take only one page at a time.

Before contributing, read the glossary and style guide 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

When someone volunteers, edit this issue with the username of the volunteer, and with the PR. Ex:

When PRs are merged, make sure to mark that page as completed!

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

API Reference

Navigation and UI

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

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

Rules of React

  • Rules of React
    • Components and Hooks must be pure
    • React calls Components and Hooks
    • Rules of Hooks

React Server Components

  • experimental Server Components
  • experimental Server Actions
  • experimental Directives
    • experimental 'use client'
    • experimental 'use server'

Legacy APIs

  • Legacy React APIs
    • Children
    • cloneElement
    • Component
    • createElement
    • createFactory
    • createRef
    • isValidElement
    • PureComponent

Optional Content

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
  • Blog
  • Warnings
@eugenetree
Copy link

Hi, I would like to translate useLayoutEffect

@PavelVyny
Copy link

Hi! I would like to translate Reusing Logic with Custom Hooks

@sergii-zhuravel
Copy link

Hi, there. I would like to translate Start a New React Project

@litovskii-s
Copy link
Contributor

litovskii-s commented Apr 25, 2023

Hi! I would like to translate Your First Component


Done in #458

@dolynchuk
Copy link

I would like to translate Tutorial: Tic Tac Toe

@gymnasy55
Copy link

I'd like to take Thinking in React

@syavik2001
Copy link
Contributor

syavik2001 commented Apr 25, 2023

Hi! I would like to translate react: Components: Fragment (<>)


Done in #460

@gaearon
Copy link
Member Author

gaearon commented Apr 25, 2023

@vldmrkl @ithompson4 @oleksii-polovyi @MargarytaChepiga

Can you please confirm whether you'd be able to steer and maintain this translation? If not, please let us know by updating https://github.com/reactjs/translations.react.dev/blob/main/langs/uk.json so that we know who is active and can set the GH permissions right. Thank you!

@EngiN33R
Copy link

Hi, I'd like to take Keeping Components Pure

@GeorgeShvab
Copy link
Contributor

GeorgeShvab commented Apr 26, 2023

Hi there. I would like to translate createPortal page


Done in #468

@bwv847
Copy link

bwv847 commented Apr 26, 2023

Hi, I'd like to translate Add React to an Existing Project


Done in #459

@harddownloader
Copy link

Hi, I'd like to translate react: APIs: lazy

@stanislavcodes
Copy link
Contributor

stanislavcodes commented Apr 29, 2023

Hey! I'd like to translate Quick Start and Tutorial: Tic Tac Toe


#466

@gaearon
Copy link
Member Author

gaearon commented May 3, 2023

@vldmrkl @ithompson4 @oleksii-polovyi @MargarytaChepiga

Can you please confirm whether you'd be able to maintain this translation? Totally understand if not, but in that case we'd need to form a new maintainer team first. Thank you!

@Kamilius
Copy link

Kamilius commented May 4, 2023

I'll start translating Editor Setup page

@vadym-oliinyk
Copy link
Contributor

vadym-oliinyk commented May 11, 2023

Hi, I'll start translating Importing and Exporting Components page.


It's done in #464

@gaearon
Copy link
Member Author

gaearon commented May 16, 2023

Hi folks,

While I appreciate everyone’s requests to take a piece of the translation, the main issue right now is that it doesn’t appear that anyone on the original maintainer team is able to steer this translation effort.

Would anyone like to volunteer to do that?

@bkatsevych
Copy link
Collaborator

Hi folks,

While I appreciate everyone’s requests to take a piece of the translation, the main issue right now is that it doesn’t appear that anyone on the original maintainer team is able to steer this translation effort.

Would anyone like to volunteer to do that?

Well, then I'd like to try

@gaearon
Copy link
Member Author

gaearon commented May 18, 2023

@bkatsevych Do you have some experience doing translations? We'd like to ideally either have maintainers who've done translations before, or to have more than one maintainer per translation.

@bkatsevych
Copy link
Collaborator

@gaearon No, unfortunately I don't. But I'm willing to do my best

@gaearon
Copy link
Member Author

gaearon commented May 18, 2023

Alright, let's give it a try. I've added you to the repo. Thanks!

@bkatsevych
Copy link
Collaborator

bkatsevych commented May 19, 2023

Hi, I would like to translate useLayoutEffect

@eugenetree, go for it!

@bkatsevych
Copy link
Collaborator

Hi! I would like to translate Reusing Logic with Custom Hooks

@PavelVyny go for it!

@bkatsevych
Copy link
Collaborator

Hi, there. I would like to translate Start a New React Project

@sergii-zhuravel it's yours, go for it!

@bkatsevych
Copy link
Collaborator

I would like to translate Tutorial: Tic Tac Toe

@dolynchuk Sounds good, go for it!

@bkatsevych
Copy link
Collaborator

I'd like to take Thinking in React

@gymnasy55 Go for it!

@gaearon
Copy link
Member Author

gaearon commented May 19, 2023

@bkatsevych Please also edit the post to include who's working on what.

@bkatsevych
Copy link
Collaborator

Hi, I'd like to translate useCallback

@poznianski go for it

@alinkedd
Copy link
Collaborator

alinkedd commented Dec 19, 2023

Working on Your UI as a Tree


#512

@alinkedd
Copy link
Collaborator

alinkedd commented Dec 22, 2023

Working on Describing the UI


#513

@alinkedd
Copy link
Collaborator

alinkedd commented Dec 22, 2023

Working on Responding to Events


#515

@alinkedd
Copy link
Collaborator

@dolynchuk @gymnasy55 @sergii-zhuravel @Kamilius @EngiN33R @PavelVyny @eugenetree @harddownloader

Please, respond with any emoji to this comment if you're planning to finish your articles in the near future.
Otherwise I will unassign you after New Year's Eve, so we could keep the list relevant and complete some of the sections.

Also you're welcome to change an article by leaving a comment if you want so.

@alinkedd
Copy link
Collaborator

alinkedd commented Dec 25, 2023

Working on State: A Component's Memory


#535

@alinkedd
Copy link
Collaborator

alinkedd commented Jan 1, 2024

@dolynchuk @gymnasy55 @sergii-zhuravel @Kamilius @PavelVyny @eugenetree @harddownloader

Your articles were unassigned because you did not respond to the related comment above in time.

Nevertheless, we are glad to welcome you back if you wish to translate articles in the future.

@GeorgeShvab
Copy link
Contributor

Hi there, I would like to translate <Suspense/> page.

@kpripper
Copy link

Hi, I'd like to translate Render and Commit

@alinkedd
Copy link
Collaborator

alinkedd commented Apr 1, 2024

I've created discord group https://discord.gg/WM6PmCpp7W to facilitate communication about Ukrainian technical translations, including work on React documentation. Feel free to join

@bkatsevych FYI

@BlindKai
Copy link

BlindKai commented Apr 1, 2024

Hello, there!
I would like to translate Tutorial: Tic-Tac-Toe page.

cc: @alinkedd

@MinichMykyta
Copy link

Ima translate the "adding interactivity" page.

@alinkedd
Copy link
Collaborator

alinkedd commented May 15, 2024

@MinichMykyta

Thanks for the quick PR. Unfortunately, I wasn’t fast enough to mention that your section intro page ‘Adding Interactivity’ includes vocabulary, references, and examples from subpages. It would be better to translate these first and then use that content in your page for the sake of consistency and ease. I will keep this PR as a draft until all or almost all internal articles are translated. Nevertheless, I’m going to add some general feedback regarding common mistakes to help you get started with our translation process.

Please translate the subpages first next time. If you have any questions, feel free to ask me on Discord: https://discord.gg/WM6PmCpp7W.

@MinichMykyta
Copy link

Got it, I am new to it. So feel free to take over whenever you think it's suitable (If you can do that on GitHub, of course). Otherwise, I'll start applying your feedback to the subpages right away.

I would like to translate the “Updating Objects in State” Subpage next.

@undead404
Copy link
Contributor

I'd like to translate “Start a New React Project”

@undead404
Copy link
Contributor

I'd like to translate “Editor Setup”

@undead404
Copy link
Contributor

I'd like to translate “State as a Snapshot” (my todo)

@undead404
Copy link
Contributor

I'd like to translate “Queuing a Series of State Updates”

@alinkedd
Copy link
Collaborator

@undead404 okay, and please, first check my review on the Editor Setup so we encounter fewer issues later

@astropsy999
Copy link
Contributor

Hi, there! I'll take "Updating Arrays in State"

@alinkedd
Copy link
Collaborator

@astropsy999 Okay, thanks for your effort!
Please, check the README and TRANSLATION files before starting the translation.
Feel free to ask me anything either here or in our chat at Discord

@undead404
Copy link
Contributor

I'd like to translate "Reacting to Input with State"

@alinkedd
Copy link
Collaborator

@undead404 thanks of choosing other subpage article instead of chapter introductory page. Here is an explanation - #457 (comment). You may finish Managing State, when subpages are ready.

@undead404
Copy link
Contributor

I'd like to translate "Choosing the State Structure"

@astropsy999
Copy link
Contributor

I'll translate "useContext"

@astropsy999
Copy link
Contributor

Next I'll take "Scaling Up with Reducer and Context", because there is a link to it in the previous one

@GeorgeShvab
Copy link
Contributor

GeorgeShvab commented Aug 23, 2024

Hi there, I would like to translate <Profiler>. I want to note that I already have one PR in review, would it be okay to take <Profiler> while previous PR in review?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests