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

[another-guy]

@gaearon I think the living word principle will make things a bit subjective. Yet I agree it's important to follow it to establish rapport with the readers and to win their attention. Thanks for raising the bar early in the process!

[gaearon]

I agree it's subjective and we should follow common sense. I'm mostly adding this so that we hold clear language as an explicit value — even if we can't always live up to it.

[tesseralis]

@gaearon Dan, do you want to publish a version of that in English for the other translations to reference?

[gaearon]

@tesseralis I'm not sure how much it applies to other languages. Russian is sufficiently different from English that noun-heavy phrasing gets clumsy. But that might not be a problem in e.g. French. I wouldn't be able to carry that nuance across.

[tesseralis]

Ah, gotcha! ^_^

[gaearon]

Я возьму Components and Props следующей.

[marichka-offen]

Can I help? I would like to translate Thinking in React

Update: PR #90

[gaearon]

Sure. Thanks.

[agoldis]

🙋🏻‍♂️ please assign me on State & Lifecycle
@tesseralis @another-guy @lex111 PR ready #42
Please update the issue body with a link. Thank you! 🥕

[Windrushfarer]

I'll get Lists and Keys
@tesseralis @another-guy @lex111 PR #64

[avevlad]

Assign me on FAQ: AJAX and APIs

[dpatrikeev]

I'll take Handling Events

[another-guy]

Conditional Rendering is the next piece for me to work on.

I also had the audacity to update the issue's description with the following volunteers/assignments:

@agoldis -- State and Lifecycle
@dpatrikeev -- Handling Events
@another-guy -- Conditional Rendering
@Windrushfarer -- Lists and Keys

[pavelkeyzik]

Hi! Can I take "Introducing Hooks" page? #84

[lex111]

@ModPhoenix не много перевёл? Пока отбой, первоначальный автор обещал отправить перевод, извини, думал, что перевод заброшен :(
Но перевести всё равно ещё есть что. Например, 404 страницу.

[vvscode]

я возьму 404 ) #229

[lex111]

@ModPhoenix @vvscode тут конкуренция образовалась, уже @musewick перевёл её в #228. Но там есть ещё одна страничка, посмотрите список ишью 😃

UPD: @vvscode перевёл уже, но всё равно @musewick быстрее тебя оказался...

Ох, ну и суматоха, спасибо за помощь! 😉

[alkhasov]

@lex111 похоже, что это я виноват в суматохе, так как не отписался тут перед началом. Я не против если будет взят PR от @vvscode

[lex111]

@musewick всё нормально, это не перевод страниц, а "допы", про которые я мимо ходом упомянул.. короче, сейчас всё разрешим!

[aamorozov]

@lex111 Sorry for the delay - i will be submitting Composition vs Inheritance translation pr later tonight. Thanks!

[lex111]

@aamorozov сожалею, но перевод уже сделан в #225, мы неоднократно упоминали вас, но вы не ответили, а ждать больше не могли. Но поскольку #225 пока не принят, я предлагаю вам присоединиться к нему и посредством suggested changes предложить свои корректировки из своего перевода (возможно, кое-что вы перевели лучше и хотите предложить), либо просто посмотреть текущий перевод и тоже предложить улучшения. Таким образом после слияния пулреквеста, в истории будут ваши предложения (в виде отдельных коммитов, а значит будет виден ваш вклад в перевод). Это единственное, что можно предложить, надеюсь на ваше понимание :)

[lex111]

Поскольку сейчас с переводами текущих страниц более-менее ясно (но опять-таки точно неизвестно, пока не будут предоставлены пулрекветы), то все желающие помочь, могут попереводить страницы из раздела "Сообщество", они короткие и несложные, а ещё их много, так что хватит всем 😊

[INQTR]

Я тогда хотел бы взять Сommunity -> Where To Get Support.

[lex111]

@ModPhoenix здорово 👍 , хотя конкретные страницы разделов Сообщества и Блога не ведём в списке, но другим будет полезно это знать, чтобы не случилось то, что было с 404-ошибкой.

[theghostbel]

Сегодня-завтра залью Test Renderer, извиняюсь за смуту, @lex111 и @ModPhoenix

[rlax]

@lex111 Lifting State Up: #238

[theghostbel]

@lex111 Test Renderer - #240

[avevlad]

@another-guy @ntishkevich Code-Splitting #246

[another-guy]

Ещё есть несколько незавершённых переводов на PR, не входящие в "ядро" документации, но в целом, v1 готов! 🎉

Разумеется, ещё нужна вычитка, полировка и устранение опечаток, но уже достигнут хороший результат. Надеюсь, что перевод в его текущем состоянии снизит "порог вхождения" в React людям, не владеющим английским языком.

Хочу лично поблагодарить:
@tesseralis и @gaearon за исходный импульс, время и усилия направленные на организацию процесса.
Отдельной строкой -- @lex111 за руководство, ревью, переводы и неформальный арбитраж на протяжении практически всего времени проекта перевода документации.
@Heegiiny, @gcor, @ntishkevich, @lfedorov, @vvscode, @avevlad, @AlLevykin, @egorzekov, @Azat74, @SmolinPavel, @ModPhoenix, @ChernikAnton, @marichka-offen, @agoldis, @RinatRezyapov и всех-всех, кто активно вносил вклад в виде переводов, ревью, обсуждений.

[tesseralis]

AHHHHHHHHH CONGRATS!!!

[another-guy]

@Heegiiny, @tesler, как обстоят ваши дела с переводами Codebase Overview и Implementation Notes? Будьте добры открыть хотя бы draft pull request для этих переводов. Если у вас нет времени, кто-то мог бы подхватить и довести дело до конца.
Спасибо!

[tesseralis]

@lex111 @gaearon @another-guy could someone look at the sync PR? It hasn't been updated for a few weeks

[IgorLesnevskiy]

Возьму в перевод Docs -> Profiler API, вроде не нашел ничего о об этой странице выше

[ntishkevich]

Возьму в перевод Docs -> Profiler API, вроде не нашел ничего о об этой странице выше

Для этой страницы, как для новых связанных с тестированием. я создавал отдельную задачу #382

[BogdanDor]

Codebase overview #427

[BogdanDor]

Implementation notes #433

[ntishkevich]

По списку задач остался перевод блога и раздела "Сообщество", для которых есть отдельные ишьюсы #273 и #408 соответственно. Думаю, это задачу можно закрывать. @lex111, @gcor что думаете по поводу закрытия этой ишью?

[gcor]

@ntishkevich, согласен, можно закрывать

[gaearon]

Спасибо всем, кто переводил! Для нового сайта: #843