Improve of documentation

Author: KonstHardy

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 ... -->
@@ -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/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`. В этом случае вы получаете доступ к контексту, как во всех методах жизненного цикла, так и в рендер-методе.
 
 > Примечание
 >

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/implementation-notes.md

@@ -111,7 +111,7 @@ rootEl.appendChild(node);
 
 * React-элементы -- просто объекты, описывающие тип компонента (например, `App`) и его пропсы.
 * Пользовательские компоненты могут быть как классами, так и функциями, но оба «рендерят» элементы.
-* «Монтирование» -- рекурсивный процесс, который создаёт DOM- или Native-дерево заданного React элемента верхнего уровня (например, `<App />`).
+* «Монтирование» -- рекурсивный процесс, который создаёт DOM- или Native-дерево заданного React-элемента верхнего уровня (например, `<App />`).
 
 ### Монтирование базовых элементов {#mounting-host-elements}
 
@@ -473,7 +473,7 @@ class DOMComponent {
 }
 ```
 
-В действительности демонтирование DOM компонентов также удаляет слушателей событий и очищает кэш, но опустим эти детали.
+В действительности демонтирование DOM-компонентов также удаляет слушателей событий и очищает кэш, но опустим эти детали.
 
 Теперь добавим верхнеуровневую функцию `unmountTree(containerNode)`, которая аналогична `ReactDOM.unmountComponentAtNode()`:
 
@@ -669,7 +669,7 @@ class DOMComponent {
 
 ### Обновление базовых компонентов {#updating-host-components}
 
-Хостовые компоненты, такие как `DOMComponent`, обновляются по-другому. Когда они получают элемент, то им необходимо обновить платформо-специфический view. В случае с React DOM, это означает обновить DOM атрибуты:
+Хостовые компоненты, такие как `DOMComponent`, обновляются по-другому. Когда они получают элемент, то им необходимо обновить платформо-специфический view. В случае с React DOM, это означает обновить DOM-атрибуты:
 
 ```js
 class DOMComponent {
@@ -702,12 +702,12 @@ class DOMComponent {
 
 В этом упрощённом примере, мы используем массив внутренних экземпляров и проходим по каждому из них, обновляя либо заменяя внутренние экземпляры, в зависимости от того, соответствует ли полученный `type` предыдущему. В реальности reconciler также берёт `key` элементов и, в добавок к вставкам и удалениям элементов, отслеживает их перемещение, но мы опустим эту деталь.
 
-Соберём DOM операции над потомками в список, чтобы мы смогли выполнить их обновление группой:
+Соберём DOM-операции над потомками в список, чтобы мы смогли выполнить их обновление группой:
 
 ```js
     // ...
 
-    // Массивы React элементов
+    // Массивы React-элементов
     var prevChildren = prevProps.children || [];
     if (!Array.isArray(prevChildren)) {
       prevChildren = [prevChildren];
@@ -786,7 +786,7 @@ class DOMComponent {
     // ...
 ```
 
-Последний шаг -- выполним DOM операции. Опять же, реальная реализация согласователя более сложная, потому что обрабатывает перемещения:
+Последний шаг -- выполним DOM-операции. Опять же, реальная реализация согласователя более сложная, потому что обрабатывает перемещения:
 
 ```js
     // ...

content/docs/introducing-jsx.md

@@ -176,7 +176,7 @@ const element = {
 
 Эти объекты называются React-элементами. Можно сказать, что они описывают результат, который мы хотим увидеть на экране. React читает эти объекты и использует их, чтобы конструировать и поддерживать DOM. 
 
-[В следующей главе](/docs/rendering-elements.html) мы углубимся в то, как React элементы рендерятся в DOM.
+[В следующей главе](/docs/rendering-elements.html) мы углубимся в то, как React-элементы рендерятся в DOM.
 
 >**Совет:**
 >