Russian Translation Progress

[tesseralis]

Текущий список мейнтейнеров

• 🥇 @lex111
• @gaearon
• @another-guy
• @Heegiiny
• @gcor
• @ntishkevich

Если у вас есть время и желание, и вы уже участвуете в развитии проекта, то можете создать пулреквест с добавлением своего логина в список мейнтейнеров в этом репозитории.

---

Как помочь с переводом

Вы можете перевести страницу из документации! Это делается в три шага:

1. Проверьте, что её никто не застолбил в чеклисте или комментариях под ним (они не сразу отражаются в чеклисте)
2. Напишите, какую страницу вы ходите перевести. Пожалуйста, не берите больше одной страницы за раз.
3. Когда страница готова, отредактируйте ваш комментарий, чтобы добавить номер пулреквеста.

Прежде чем переводить, обязательно прочитайте местные правила перевода!

Пожалуйста, не тяните с переводами! Если у вас не получается или нет времени, отпишитесь, чтобы кто-то другой мог подхватить эту страницу.

For maintainers

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

• Home Page (@tesseralis) Russian Translation Progress #1

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

Core Pages

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

• Home Page (@lex111)
• Tutorial (@vvscode) Tutorial #201

Basics

• Hello World (@ModPhoenix) Added page translation: basics -> hello world #2
• Introducing JSX (@another-guy) Перевод "introducing-jsx.md" на русский #17
• Rendering Elements (@Heegiiny) Added page translation: basics -> rendering elements #11
• Components and Props (@gaearon) Translate "Components and Props" into Russian #34
• State and Lifecycle (@agoldis) Translate "State and Lifecycle" (state-and-lifecycle.md) #42
• Handling Events (@dpatrikeev) Translate "Handling events" #89
• Conditional Rendering (@another-guy) Translate "Conditional Rendering" into Russian #60
• Lists and Keys (@Windrushfarer) Translation List and keys #64
• Forms (@thechch) Translate "Forms" #174
• Lifting State Up (@rlax) Translate lifting-state-up.md #238
• Composition vs Inheritance (@aamorozov & @gcor) composition-vs-inheritance.md #225
• Thinking in React (@marichka-offen) translate Thinking in React #90

API Reference

• React (@ModPhoenix) Translate "React Top-Level API" into Russian #66
• React.Component (@gcor) Перевод React.Component #131
• ReactDOM (@akhudiakov97) React Dom Translation #126
• ReactDOMServer (reassigned to @mikhail-hatsilau) Translated react-dom-server page #207
• DOM Elements (@ivankayzer) Translate "DOM elements" #88
• SyntheticEvent (@dmtrKovalenko) Translate "SyntheticEvent" #122
• Test Utilities (@shonoru) "Test Utilities" перевод на русский #97
• Shallow Renderer (@Yakimych) Translate Shallow Renderer #99, Update addons-shallow-renderer.md #110
• Test Renderer (@theghostbel +-@ModPhoenix) Translate Test Renderer to Russian #240
• JS Environment Requirements (@kuhelbeher) JS environment-requirements #68
• Glossary (@marichka-offen) translation of reference-glossary #200

Navigation

These are the navigation links that appears in the sidebar. Possibly wait until
the corresponding sections are translated to do these.

• tutorial/nav.yml
• docs/nav.yml

Next Steps

These are the next most important translations, ordered by importance:

Installation

• Getting Started (@AlLevykin) Translate "Getting Started" (getting-started.md) #39
• Add React to a Website (@shvedovskiy) Translate Add React to a Website #96
• Create a New React App (reassigned to @ChernikAnton) Translate Сreate a New React App #242
• CDN Links (@lex111) Translate CDN Links #28

Hooks

Everyone is hooked on hooks! People are really excited for these and it would be great for them to be translated.

• Introducing Hooks (@pavelkeyzik) Hooks intro page translated #84
• Hooks at a Glance (@Hisagr) Translation hooks-overview page #65
• Using the State Hook (@another-guy) Translate Using the State Hook #134
• Using the Effect Hook (@Hisagr) Translation Using the Effect Hook #112
• Rules of Hooks (@airyboy) Rules of Hooks translation #86
• Building Your Own Hooks (@tesler) Translate "Building Your Own Hooks" #150
• Hooks API Reference (@polling) Hooks reference #226
• Hooks FAQ (@egorzekov) "Hooks FAQ" - "Хуки - вопросы и ответы" - ready #208

Warnings

These are the pages that you get when you click the links in the console (e.g. https://reactjs.org/warnings/dont-call-proptypes.html). People tend to search these, so please don't translate the error message itself.

• dont-call-proptypes (@lex111) Translate "Don't Call PropTypes Warning" #143
• invalid-aria-prop (@lex111) Translate "Invalid ARIA Prop Warning" #144
• invalid-hook-call-warning (@lex111) Translate "Invalid Hook Call Warning" #145
• legacy-factories (@lex111) Translate React Element Factories and JSX Warning #31
• refs-must-have-owner (@vvscode) Предупреждение: Refs Must Have Owner #119
• special-props (@lex111) Translate Special Props Warning #32
• unknown-prop (@another-guy) Translate Unknown Prop Warning #212

Advanced Guides

• Accessibility (reassigned to @AlLevykin) Translate Accessibility (accessibility.md). #239
• Code-Splitting (@avevlad) Translate "Code-Splitting" into Russian #246
• Context (@egorzekov) Context translation (ready) #164
• Error Boundaries (@mzhukov1973) Translation of Error Boundaries into Russian #73
• Forwarding Refs (@Heegiiny) Translation Forwarding refs #117
• Fragments (@ntishkevich) Translation Fragments #120
• Higher-Order Components (@agoldis) Translate Higher Order Components #167
• Integrating with Other Libraries (@vvscode) Интеграция со сторонними библиотеками #159
• JSX In Depth (@RenatRysaev) Jsx in depth #206
• Optimizing Performance (@RenatRysaev) Translate Optimizing performance #141
• Portals (@echobrain) Translate "Рortals" #153
• React Without ES6 (@DopustimVladimir) Translate React Without ES6 #177
• React Without JSX (@vvscode) React без JSX #118
• Reconciliation (@astralpunch) Translate Reconciliation #139
• Refs and the DOM (reassigned to @SmolinPavel) Translate Refs and the DOM #236
• Render Props (@Azat74) Add translate for render-props #163
• Static Type Checking (@acilsd) Translate Advanced Guides -> Static Type Checking #166
• Strict Mode (@ntishkevich) Translate "Strict Mode" #178
• Typechecking With PropTypes (@vvscode) Проверка типов с помощью PropTypes #129
• Uncontrolled Components (@lex111) Translate Uncontrolled Components #37
• Web Components (@mzhukov1973 -> @ntishkevich) Translate Web Components #234

FAQ

• APIs and AJAX (@avevlad) Translate "AJAX and APIs" into Russian #30
• Babel, JSX, and Build Steps (@avevlad) Translate "Babel, JSX, and Build Steps" into Russian #38
• Passing Functions to Components (@marichka-offen) Translation FAQ passing functions to components #95 Translation FAQ: Passing Functions to Components #108
• Component State (@Nadjakoroleva) Translate FAQ Component State #36
• Styling and CSS (@T1mofey1) Translate "faq-styling" #183
• File Structure (@RinatRezyapov) Translation FAQ File Structure (faq-structure.md) #98
• Versioning Policy (@DmitryMarkov) Translate "FAQ: Versioning Policy" #171
• Virtual DOM and Internals (@ivaneroshkin) Translate "Virtual DOM" #161

Contributing

Priority: Low

• How to Contribute (@AlLevykin) Translate "How to Contribute" (how-to-contribute.md) #149
• Codebase Overview (@BogdanDor) Translation codebase overview #427
• Implementation Notes (@BogdanDor) Translate implementation notes #433
• Design Principles (@echobrain) part 1 - Translation design principles pt1 #244, part 2 - Translation design principles pt2 #258

Components

Components in src/components that have some text in them.

• CodeEditor
• CodeExample
• ErrorDecoder
• LayoutFooter
• LayoutHeader
• MarkdownPage

Additional Translations

These are not the primary translation targets.

• Blog
• Community

[INQTR]

I took this page in translation: Basics -> Hello World. Tonight will do PR.

upd

Here is my PR with the translation #2

[doasync]

This can help with translation: https://learn-reactjs.ru
EDIT: I'm not the author

[lex111]

Hi @stsiushkevich,

You have done a lot of translation work, it's very cool! 👍
But would you like to join the official Russian translation? That was great... Moreover, why should we have two translations, let's join our efforts to create only one translation on React, what do you think about this?

[another-guy]

@lex111 @tesseralis I'd like to get a bit of coordination/direction here. Couple of questions:

• First: Should I wait until we decide whether we want to get the official translation based of the one by @stsiushkevich? Or is it okay to pick a page to translate now (if so, I'd pick the Introducing JSX tentatively)?
  Using existing progress will definitely save the translation time but will add the review time to make sure the info is up-to-date.

• Second: Are we willing to use Crowdin or not? I have no preference since I've never used that service in the past.

[lex111]

Regardless of the decision of @stsiushkevich, we will do our own translation, i.e. definitely not copy and paste, which is wrong and violates copyright. But this was a great collaboration, of course, so I hope for a favorable solution...

Regarding to:

• Or is it okay to pick a page to translate now (if so, I'd pick the Introducing JSX tentatively)?

Of course, you can already do the translation!

By the way, check out my partial translation (https://github.com/js-ru/react-ru), maybe this will help!

• Second: Are we willing to use Crowdin or not? I have no preference since I've never used that service in the past.

Crowdin will not be used, translation will be done via GitHub, it can be used as a starting point (if there is any translation there).

[another-guy]

@lex111 Thank you for clarification.

I'm removing the paragraph about Crowdin from this issue's description to avoid confusion among new contributors.

[tesseralis]

@doasync would you be interested in being a maintainer? You already have a lot of experience with this and we could use your guidance, and we would love to take advantage of the work that you've done already.

The advantage of an official translation is that it can be reached directly from reactjs.org -- not docschina, not learn-reactjs.ru. We're also planning on using a bot to automatically submit pull requests when there are updates to the master branch.

[lex111]

@tesseralis small amendment, @stsiushkevich is author learn-reactjs.ru, not @doasync.

[Heegiiny]

I will translate the Basics >Rendering Elements page.

upd: Pull request #11 with translation is created.

[gaearon]

I suggest a principle we should follow throughout the translations: #6