Merge pull request #691 from KonstHardy/improve-documentation

Improve of documentation

Author: lex111

content/community/support.md

@@ -17,7 +17,7 @@ React имеет сообщество из миллионов разработч
 * [react_js](https://telegram.me/react_js) - самое крупное русскоговорящее сообщество по React
 * [react_ru](http://t.me/react_ru) - независимое сообщество React-разработчиков на русском языке
 
-Прежде чем вступить в React сообщество, пожалуйста, [прочтите правила поведения](https://github.com/facebook/react/blob/main/CODE_OF_CONDUCT.md). Также мы приняли [соглашение участника](https://www.contributor-covenant.org/) и ожидаем, что все участники сообщества будут его придерживаться.
+Прежде чем вступить в React-сообщество, пожалуйста, [прочтите правила поведения](https://github.com/facebook/react/blob/main/CODE_OF_CONDUCT.md). Также мы приняли [соглашение участника](https://www.contributor-covenant.org/) и ожидаем, что все участники сообщества будут его придерживаться.
 
 ## Stack Overflow {#stack-overflow}
 

content/docs/add-react-to-a-website.md

@@ -21,15 +21,15 @@ next: create-a-new-react-app.html
 
 ## Добавляем React за одну минуту {#add-react-in-one-minute}
 
-В этом разделе вы научитесь добавлять React на существующую HTML-страницу. Вы можете практиковаться на своём собственном сайте или создать для этого пустой HTML файл.
+В этом разделе вы научитесь добавлять React на существующую HTML-страницу. Вы можете практиковаться на своём собственном сайте или создать для этого пустой HTML-файл.
 
 Мы не будем пользоваться сложными инструментами сборки или что-то устанавливать. **Всё, что вам нужно -- это доступ к Интернету и минута свободного времени**.
 
 Необязательно: [скачать готовый пример (архив 2 Кбайт)](https://gist.github.com/gaearon/6668a1f6986742109c00a581ce704605/archive/f6c882b6ae18bde42dcf6fdb751aae93495a2275.zip)
 
 ### Шаг 1: Добавляем DOM-контейнер в HTML {#step-1-add-a-dom-container-to-the-html}
 
-Для начала, откройте HTML файл страницы, которую хотите отредактировать. Добавьте пустой тег `<div>` в месте, где вы хотите отобразить что-нибудь с помощью React. Например:
+Для начала, откройте HTML-файл страницы, которую хотите отредактировать. Добавьте пустой тег `<div>` в месте, где вы хотите отобразить что-нибудь с помощью React. Например:
 
 ```html{3}
 <!-- ... остальной HTML ... -->
@@ -39,7 +39,7 @@ next: create-a-new-react-app.html
 <!-- ... остальной HTML ... -->
 ```
 
-Затем назначьте созданному `<div>` уникальный атрибут `id`. Это позволит впоследствии найти тег из JavaScript кода и отобразить React-компоненты внутри него.
+Затем назначьте созданному `<div>` уникальный атрибут `id`. Это позволит впоследствии найти тег из JavaScript-кода и отобразить React-компоненты внутри него.
 
 >Совет
 >
@@ -67,7 +67,7 @@ next: create-a-new-react-app.html
 
 ### Шаг 3: Создаём React-компонент {#step-3-create-a-react-component}
 
-Создайте файл с именем `like_button.js` рядом с вашим HTML файлом.
+Создайте файл с именем `like_button.js` рядом с вашим HTML-файлом.
 
 Возьмите **[этот стартовый код](https://gist.github.com/gaearon/0b180827c190fe4fd98b4c7f570ea4a8/raw/b9157ce933c79a4559d2aa9ff3372668cce48de7/LikeButton.js)** и вставьте его в созданный ранее файл.
 

content/docs/addons-test-utils.md

@@ -298,7 +298,7 @@ findRenderedComponentWithType(
 renderIntoDocument(element)
 ```
 
-Отображает React элемент в отдельно взятом DOM-узле документа. **Этой функции нужен DOM.** Это фактически эквивалентно:
+Отображает React-элемент в отдельно взятом DOM-узле документа. **Этой функции нужен DOM.** Это фактически эквивалентно:
 
 ```js
 const domContainer = document.createElement('div');

content/docs/codebase-overview.md

@@ -111,13 +111,13 @@ React является [монолитным репозиторием](https://d
 
 Изначально React создавался для DOM, но позже был адаптирован к другим платформам, таким как [React Native](https://reactnative.dev/). В этом разделе мы расскажем об используемых рендерерах.
 
-**Рендереры превращают React дерево в платформо-специфический код.**
+**Рендереры превращают React-дерево в платформо-специфический код.**
 
 Они расположены в каталоге [`packages/`](https://github.com/facebook/react/tree/main/packages/):
 
 * [React DOM Renderer](https://github.com/facebook/react/tree/main/packages/react-dom) рендерит React-компоненты в DOM. Он реализует [`ReactDOM` API](/docs/react-dom.html) и доступен как пакет [`react-dom`](https://www.npmjs.com/package/react-dom) из npm репозитория. Можно подключать как отдельный бандл `react-dom.js`, экспортирующий глобальную переменную `ReactDOM`.
-* [React Native Renderer](https://github.com/facebook/react/tree/main/packages/react-native-renderer) рендерит React компоненты в нативные представления. Используется внутри React Native.
-* [React Test Renderer](https://github.com/facebook/react/tree/main/packages/react-test-renderer) рендерит React компоненты в JSON-дерево. Используется при [тестировании снимками](https://facebook.github.io/jest/blog/2016/07/27/jest-14.html) через фреймворк [Jest](https://facebook.github.io/jest) и доступен как пакет [react-test-renderer](https://www.npmjs.com/package/react-test-renderer) в npm.
+* [React Native Renderer](https://github.com/facebook/react/tree/main/packages/react-native-renderer) рендерит React-компоненты в нативные представления. Используется внутри React Native.
+* [React Test Renderer](https://github.com/facebook/react/tree/main/packages/react-test-renderer) рендерит React-компоненты в JSON-дерево. Используется при [тестировании снимками](https://facebook.github.io/jest/blog/2016/07/27/jest-14.html) через фреймворк [Jest](https://facebook.github.io/jest) и доступен как пакет [react-test-renderer](https://www.npmjs.com/package/react-test-renderer) в npm.
 
 Мы начали поддерживать единственный неофициальный рендерер [`react-art`](https://github.com/facebook/react/tree/main/packages/react-art), который раньше находился в отдельном [GitHub-репозитории](https://github.com/reactjs/react-art).
 

content/docs/concurrent-mode-adoption.md

@@ -139,6 +139,6 @@ ReactDOM.unstable_createRoot(
 
 </div>
 
-\*: Старый режим имеет автоматический пакетный рендеринг для обрабатываемых React событий, но он ограничен одним потоком браузера. Не React-события должны быть обработаны через `unstable_batchedUpdates`. В блокирующем и конкурентном режимах все вызовы `setState` группируются для пакетного рендеринга по-умолчанию.
+\*: Старый режим имеет автоматический пакетный рендеринг для обрабатываемых React-событий, но он ограничен одним потоком браузера. Не React-события должны быть обработаны через `unstable_batchedUpdates`. В блокирующем и конкурентном режимах все вызовы `setState` группируются для пакетного рендеринга по-умолчанию.
 
 \*\*: Предупреждения в режиме разработки.

content/docs/concurrent-mode-suspense.md

@@ -117,7 +117,7 @@ function ProfileTimeline() {
 
 Итак, в чём идея задержки? Есть несколько вариантов ответа на этот вопрос:
 
-* **Она позволит глубже интегрировать React в библиотеки получения данных.** Если библиотека получения данных реализует поддержку задержки, её использование из React компонентов будет выглядеть естественно.
+* **Она позволит глубже интегрировать React в библиотеки получения данных.** Если библиотека получения данных реализует поддержку задержки, её использование из React-компонентов будет выглядеть естественно.
 
 * **Она позволит вам управлять намеренно спроектированными состояниями загрузки.** Она не говорит _как_ данные получены, но позволит вам лучше контролировать визуальную последовательность загрузки вашего приложения.
 

content/docs/conditional-rendering.md

@@ -148,7 +148,7 @@ ReactDOM.render(
 
 [**Посмотреть на CodePen**](https://codepen.io/gaearon/pen/ozJddz?editors=0010)
 
-Приведённый выше вариант работает корректно, потому что в JavaScript выражение `true && expression` всегда вычисляется как `expression`, а выражение `false && expression` — как `false`.
+Приведённый выше вариант работает корректно, потому что в JavaScript-выражение `true && expression` всегда вычисляется как `expression`, а выражение `false && expression` — как `false`.
 
 То есть, если условие истинно (`true`), то элемент, идущий непосредственно за `&&`, будет передан на вывод. Если же оно ложно (`false`), то React проигнорирует и пропустит его.
 

content/docs/context.md

@@ -163,7 +163,7 @@ class MyClass extends React.Component {
 MyClass.contextType = MyContext;
 ```
 
-В свойство класса `contextType` может быть назначен объект контекста, созданный с помощью [`React.createContext()`](#reactcreatecontext). С помощью этого свойства вы можете использовать ближайшее и актуальное значение указанного контекста при помощи `this.context`. В этом случае вы получаете доступ к контексту, как во всех методах жизненного цикла, так и в рендер методе.
+В свойство класса `contextType` может быть назначен объект контекста, созданный с помощью [`React.createContext()`](#reactcreatecontext). С помощью этого свойства вы можете использовать ближайшее и актуальное значение указанного контекста при помощи `this.context`. В этом случае вы получаете доступ к контексту, как во всех методах жизненного цикла, так и в рендер-методе.
 
 > Примечание
 >
@@ -216,7 +216,7 @@ MyContext.displayName = 'MyDisplayName';
 
 ### Динамический контекст {#dynamic-context}
 
-Более сложный пример динамических значений для UI темы:
+Более сложный пример динамических значений для UI-темы:
 
 **theme-context.js**
 `embed:context/theme-detailed-theme-context.js`

content/docs/create-a-new-react-app.md

@@ -22,7 +22,7 @@ next: cdn-links.html
 
 ## Возможно, вам не нужен дополнительный набор инструментов {#you-might-not-need-a-toolchain}
 
-Если у вас нет проблем, описанных выше, или пока не чувствуете себя уверенно, используя инструменты JavaScript, рассмотрите возможность [добавления React в виде простого тега `<script>` на HTML странице](/docs/add-react-to-a-website.html), [при необходимости с JSX](/docs/add-react-to-a-website.html#optional-try-react-with-jsx).
+Если у вас нет проблем, описанных выше, или пока не чувствуете себя уверенно, используя инструменты JavaScript, рассмотрите возможность [добавления React в виде простого тега `<script>` на HTML-странице](/docs/add-react-to-a-website.html), [при необходимости с JSX](/docs/add-react-to-a-website.html#optional-try-react-with-jsx).
 
 Также это **самый простой способ добавить React в существующий веб-сайт**. Вы всегда можете расширить набор инструментов, если посчитаете это нужным.
 

content/docs/design-principles.md

@@ -149,7 +149,7 @@ React не является универсальной библиотекой о
 
 Аналогичную роль играет [JSX](/docs/introducing-jsx.html). Хотя он необязателен для работы React, мы широко используем его в Facebook как по эстетическим, так и по практическим соображениям.
 
-В нашей кодовой базе JSX предоставляет однозначную подсказку инструментам, что они работают с деревом React-элементов. Это позволяет добавлять оптимизации во время сборки, такие как [всплытие неизменяющихся элементов](https://babeljs.io/docs/en/babel-plugin-transform-react-constant-elements/), безопасный анализ и использование внутреннего компонента codemod, а также добавление в предупреждения [пути до исходников JSX кода](https://github.com/facebook/react/pull/6771).
+В нашей кодовой базе JSX предоставляет однозначную подсказку инструментам, что они работают с деревом React-элементов. Это позволяет добавлять оптимизации во время сборки, такие как [всплытие неизменяющихся элементов](https://babeljs.io/docs/en/babel-plugin-transform-react-constant-elements/), безопасный анализ и использование внутреннего компонента codemod, а также добавление в предупреждения [пути до исходников JSX-кода](https://github.com/facebook/react/pull/6771).
 
 ### Использование React в Facebook {#dogfooding}