From 0decb9d5232fdf4ddad75d61ce5a183e2049a55c Mon Sep 17 00:00:00 2001
From: akhudiakov97 <akhudiakov97@gmail.com>
Date: Wed, 13 Feb 2019 21:30:42 +0200
Subject: [PATCH 01/17] React Dom Translation

---
 content/docs/reference-react-dom.md | 71 ++++++++++++++---------------
 1 file changed, 35 insertions(+), 36 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 3732ebe8d..ff06a95e7 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -6,11 +6,11 @@ category: Reference
 permalink: docs/react-dom.html
 ---
 
-If you load React from a `<script>` tag, these top-level APIs are available on the `ReactDOM` global. If you use ES6 with npm, you can write `import ReactDOM from 'react-dom'`. If you use ES5 with npm, you can write `var ReactDOM = require('react-dom')`.
+Если вы загружаете React с помощью тэга `<script>`, эти высокоуровневые API доступны через глобальный `ReactDOM`. Если вы используете ES6 с npm, вы можете написать `import ReactDOM from 'react-dom'`.Если вы используете ES5 с npm, вы можете написать `var ReactDOM = require('react-dom')`.
 
-## Overview {#overview}
+## Обзор
 
-The `react-dom` package provides DOM-specific methods that can be used at the top level of your app and as an escape hatch to get outside of the React model if you need to. Most of your components should not need to use this module.
+Пакет `react-dom` предостваляет специфические DOM методы которые могут быть использованы на верхнем уровне вашего приложения и как пожарный выход для того чтобы выйти из модели React если вам будет нужно. Большинство из ваших компонентов не должны использовать этот модуль
 
 - [`render()`](#render)
 - [`hydrate()`](#hydrate)
@@ -18,97 +18,96 @@ The `react-dom` package provides DOM-specific methods that can be used at the to
 - [`findDOMNode()`](#finddomnode)
 - [`createPortal()`](#createportal)
 
-### Browser Support {#browser-support}
+### Поддержка Браузерами
 
-React supports all popular browsers, including Internet Explorer 9 and above, although [some polyfills are required](/docs/javascript-environment-requirements.html) for older browsers such as IE 9 and IE 10.
+React поддерживает все популярные браузеры, включая Internet Explorer 9 and выше, хотя [иногда вам понадобятся некоторые полифиллы](/docs/javascript-environment-requirements.html) для более старых браузеров, например IE 9 или IE 10.
 
 > Note
 >
-> We don't support older browsers that don't support ES5 methods, but you may find that your apps do work in older browsers if polyfills such as [es5-shim and es5-sham](https://github.com/es-shims/es5-shim) are included in the page. You're on your own if you choose to take this path.
+> Мы не поддерживаем более старые браузеры, которые не поддерживают ES5 методы, но вы можете обнаружить, что ваши программы работают в более старых браузерах если полифиллы вроде [es5-shim and es5-sham](https://github.com/es-shims/es5-shim) уже присутствуют на страницы. Вы будете сами по себе если решите пойти по этой дороге.
 
 * * *
 
-## Reference {#reference}
+## Ссылка
 
-### `render()` {#render}
+### `render()`
 
 ```javascript
 ReactDOM.render(element, container[, callback])
 ```
 
-Render a React element into the DOM in the supplied `container` and return a [reference](/docs/more-about-refs.html) to the component (or returns `null` for [stateless components](/docs/components-and-props.html#functional-and-class-components)).
+Производит рендер React элемента внутрь DOM в предоставленный `container` and возвращает [ссылку](/docs/more-about-refs.html) на компонент (или возвращает `null` для [компонентов без состояния](/docs/components-and-props.html#functional-and-class-components)).
 
-If the React element was previously rendered into `container`, this will perform an update on it and only mutate the DOM as necessary to reflect the latest React element.
+Если React элемент был предварительно отрендерен в `container`, это произведёт его обновление и мутирует DOM по необходимости для того чтобы отражать последний React элемент.
 
-If the optional callback is provided, it will be executed after the component is rendered or updated.
+Если предоставляется дополнительный обратный вызов, он будет выполнен после того, как компонент будет отрендерен или обновлен.
 
 > Note:
 >
-> `ReactDOM.render()` controls the contents of the container node you pass in. Any existing DOM elements inside are replaced when first called. Later calls use React’s DOM diffing algorithm for efficient updates.
+> `ReactDOM.render()` управляет содержимым передаваемого вами узла контейнера. Любые существующие элементы DOM внутри заменяются при первом вызове. Более поздние вызовы используют алгоритм отслеживания изменений React DOM для эффективного обновления.
 >
-> `ReactDOM.render()` does not modify the container node (only modifies the children of the container). It may be possible to insert a component to an existing DOM node without overwriting the existing children.
+> `ReactDOM.render()` не изменяет узел контейнера (изменяет только дочерние элементы контейнера). Возможно вставить компонент в существующий узел DOM без перезаписи существующих дочерних элементов.
 >
-> `ReactDOM.render()` currently returns a reference to the root `ReactComponent` instance. However, using this return value is legacy
-> and should be avoided because future versions of React may render components asynchronously in some cases. If you need a reference to the root `ReactComponent` instance, the preferred solution is to attach a
-> [callback ref](/docs/more-about-refs.html#the-ref-callback-attribute) to the root element.
+> `ReactDOM.render()` в настоящее время возвращает ссылку на корневой экземпляр `ReactComponent`. Однако использование этого возвращаемого значения является устаревшим
+> и этого следует избегать, потому что в будущих версиях React компоненты могут отображаться асинхронно в некоторых случаях. Если вам нужна ссылка на корневой экземпляр `ReactComponent`, предпочтительным решением является прикрепить
+> [callback ref](/docs/more-about-refs.html#the-ref-callback-attribute) к корневому элементу.
 >
-> Using `ReactDOM.render()` to hydrate a server-rendered container is deprecated and will be removed in React 17. Use [`hydrate()`](#hydrate) instead.
+> Использование `ReactDOM.render()` для поддержки контейнера отрендеренного на сервере устарел и будет удален в React 17. Используйте [`hydrate()`](#hydrate) вместо этого.
 
 * * *
 
-### `hydrate()` {#hydrate}
+### `hydrate()`
 
 ```javascript
 ReactDOM.hydrate(element, container[, callback])
 ```
 
-Same as [`render()`](#render), but is used to hydrate a container whose HTML contents were rendered by [`ReactDOMServer`](/docs/react-dom-server.html). React will attempt to attach event listeners to the existing markup.
+Тоже что и [`render()`](#render), но используется для гидратации контейнера, содержимое HTML которого было отрендеренного [`ReactDOMServer`](/docs/react-dom-server.html). React попытается присоединить прослушиватели событий к существующей разметке.
 
-React expects that the rendered content is identical between the server and the client. It can patch up differences in text content, but you should treat mismatches as bugs and fix them. In development mode, React warns about mismatches during hydration. There are no guarantees that attribute differences will be patched up in case of mismatches. This is important for performance reasons because in most apps, mismatches are rare, and so validating all markup would be prohibitively expensive.
+React ожидает, что отображаемый контент идентичен на сервере и клиенте. Он может исправлять различия в текстовом содержимом, но вы должны рассматривать несоответствия как ошибки и исправлять их. В режиме разработки React предупреждает о несоответствиях во время гидратации. Нет никаких гарантий, что различия атрибутов будут исправлены в случае несовпадений. Это важно по соображениям производительности, поскольку в большинстве приложений несоответствия встречаются редко, и поэтому проверка всей разметки будет непомерно дорогой.
 
-If a single element's attribute or text content is unavoidably different between the server and the client (for example, a timestamp), you may silence the warning by adding `suppressHydrationWarning={true}` to the element. It only works one level deep, and is intended to be an escape hatch. Don't overuse it. Unless it's text content, React still won't attempt to patch it up, so it may remain inconsistent until future updates.
+Если атрибут отдельного элемента или текстовое содержимое неизбежно отличается между сервером и клиентом (например, отметка времени), вы можете отключить предупреждение, добавив `suppressHydrationWarning={true}` к элементу. Он работает только на один уровень в глубину и предназначен для спасательного люка. Не злоупотребляйте этим. Если это не текстовый контент, React по-прежнему не будет пытаться его исправить, поэтому он может оставаться несовместимым до будущих обновлений.
 
-If you intentionally need to render something different on the server and the client, you can do a two-pass rendering. Components that render something different on the client can read a state variable like `this.state.isClient`, which you can set to `true` in `componentDidMount()`. This way the initial render pass will render the same content as the server, avoiding mismatches, but an additional pass will happen synchronously right after hydration. Note that this approach will make your components slower because they have to render twice, so use it with caution.
+Если вам преднамеренно нужно визуализировать что-то другое на сервере и клиенте, вы можете выполнить двухпроходный рендеринг. Компоненты, которые визуализируют что-то другое на клиенте, могут читать переменную состояния, такую как `this.state.isClient`, которую вы можете установить в  `true` в `componentDidMount()`. Таким образом, начальный этап рендеринга будет отображать тот же контент, что и сервер, избегая несовпадений, но дополнительный этап будет происходить синхронно сразу после гидратации. Обратите внимание, что этот подход замедлит ваши компоненты, потому что они должны визуализироваться дважды, поэтому используйте его с осторожностью.
 
-Remember to be mindful of user experience on slow connections. The JavaScript code may load significantly later than the initial HTML render, so if you render something different in the client-only pass, the transition can be jarring. However, if executed well, it may be beneficial to render a "shell" of the application on the server, and only show some of the extra widgets on the client. To learn how to do this without getting the markup mismatch issues, refer to the explanation in the previous paragraph.
+Помните, что нужно помнить о пользовательском опыте на медленных соединениях. Код JavaScript может загружаться значительно позже исходного HTML-рендеринга, поэтому, если вы рендерите что-то другое только для клиента, переход может вызвать раздражение. Тем не менее, при правильном выполнении может оказаться полезным отобразить «оболочку» приложения на сервере и показать только некоторые дополнительные виджеты на клиенте. Чтобы узнать, как это сделать без проблем с разметкой, обратитесь к объяснению в предыдущем абзаце.
 
 * * *
 
-### `unmountComponentAtNode()` {#unmountcomponentatnode}
+### `unmountComponentAtNode()`
 
 ```javascript
 ReactDOM.unmountComponentAtNode(container)
 ```
 
-Remove a mounted React component from the DOM and clean up its event handlers and state. If no component was mounted in the container, calling this function does nothing. Returns `true` if a component was unmounted and `false` if there was no component to unmount.
-
+Удалите смонтированный компонент React из DOM и очистите его обработчики событий и состояние. Если в контейнере не было смонтировано ни одного компонента, вызов этой функции ничего не делает. Возвращает `true` если компонент был размонтированand `false` если не было компонента для размонтирования.
 * * *
 
-### `findDOMNode()` {#finddomnode}
+### `findDOMNode()`
 
-> Note:
+> Заметка:
 >
-> `findDOMNode` is an escape hatch used to access the underlying DOM node. In most cases, use of this escape hatch is discouraged because it pierces the component abstraction. [It has been deprecated in `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
+> `findDOMNode` это аварийный выход, используемый для доступа к базовому узлу DOM. В большинстве случаев использование этого аварийного люка не рекомендуется, поскольку оно пробивает абстракцию компонента. [Это устарело в `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
 
 ```javascript
 ReactDOM.findDOMNode(component)
 ```
-If this component has been mounted into the DOM, this returns the corresponding native browser DOM element. This method is useful for reading values out of the DOM, such as form field values and performing DOM measurements. **In most cases, you can attach a ref to the DOM node and avoid using `findDOMNode` at all.**
+Если этот компонент был смонтирован в DOM, он возвращает соответствующий элемент DOM собственного браузера. Этот метод полезен для чтения значений из DOM, таких как значения полей формы и выполнения измерений DOM. **В большинстве случаев, вы можете присоеденить к реф к узлу DOM и избегать использования `findDOMNode` вовсе.**
 
-When a component renders to `null` or `false`, `findDOMNode` returns `null`. When a component renders to a string, `findDOMNode` returns a text DOM node containing that value. As of React 16, a component may return a fragment with multiple children, in which case `findDOMNode` will return the DOM node corresponding to the first non-empty child.
+Когда компонент рендерится в `null` или` false`, `findDOMNode` возвращает` null`. Когда компонент выполняет рендеринг в строку, `findDOMNode` возвращает текстовый узел DOM, содержащий это значение. Начиная с React 16, компонент может возвращать фрагмент с несколькими дочерними элементами, и в этом случае findDOMNode возвращает узел DOM, соответствующий первому непустому дочернему элементу.
 
-> Note:
+> Заметка:
 >
-> `findDOMNode` only works on mounted components (that is, components that have been placed in the DOM). If you try to call this on a component that has not been mounted yet (like calling `findDOMNode()` in `render()` on a component that has yet to be created) an exception will be thrown.
+> `findDOMNode` работает только с подключенными компонентами (то есть компонентами, которые были размещены в DOM). Если вы попытаетесь вызвать это для компонента, который еще не был смонтирован (например, вызов `findDOMNode ()` в `render ()` для компонента, который еще не создан), будет сгенерировано исключение.
 >
-> `findDOMNode` cannot be used on function components.
+> `findDOMNode` не может использоваться с функциональными компонентами.
 
 * * *
 
-### `createPortal()` {#createportal}
+### `createPortal()`
 
 ```javascript
 ReactDOM.createPortal(child, container)
 ```
 
-Creates a portal. Portals provide a way to [render children into a DOM node that exists outside the hierarchy of the DOM component](/docs/portals.html).
+Создает портал. Порталы предоставляют способ [визуализировать дочерние элементы в узле DOM, который существует вне иерархии компонента DOM](/docs/portals.html).

From 86389dbef949a19ef409c244bb4be819003e32d8 Mon Sep 17 00:00:00 2001
From: akhudiakov97 <akhudiakov97@gmail.com>
Date: Fri, 15 Feb 2019 20:41:32 +0200
Subject: [PATCH 02/17] Updated Translation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Здравствуйте, вот изменения, не можете подсказать, как правильно перевести hydrate?
---
 content/docs/reference-react-dom.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index ff06a95e7..b81026f92 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -10,7 +10,7 @@ permalink: docs/react-dom.html
 
 ## Обзор
 
-Пакет `react-dom` предостваляет специфические DOM методы которые могут быть использованы на верхнем уровне вашего приложения и как пожарный выход для того чтобы выйти из модели React если вам будет нужно. Большинство из ваших компонентов не должны использовать этот модуль
+Пакет `react-dom` предостваляет специфические DOM методы которые могут быть использованы на верхнем уровне вашего приложения и как лазейка для того чтобы выйти из модели React если вам будет нужно. Большинство из ваших компонентов не должны использовать этот модуль
 
 - [`render()`](#render)
 - [`hydrate()`](#hydrate)
@@ -24,7 +24,7 @@ React поддерживает все популярные браузеры, в
 
 > Note
 >
-> Мы не поддерживаем более старые браузеры, которые не поддерживают ES5 методы, но вы можете обнаружить, что ваши программы работают в более старых браузерах если полифиллы вроде [es5-shim and es5-sham](https://github.com/es-shims/es5-shim) уже присутствуют на страницы. Вы будете сами по себе если решите пойти по этой дороге.
+> Мы не поддерживаем более старые браузеры, которые не поддерживают ES5 методы, но вы можете обнаружить, что ваши программы работают в более старых браузерах если полифиллы вроде [es5-shim and es5-sham](https://github.com/es-shims/es5-shim) уже присутствуют на странице. Вы будете сами по себе, если решите пойти этой дорогой.
 
 * * *
 
@@ -36,11 +36,11 @@ React поддерживает все популярные браузеры, в
 ReactDOM.render(element, container[, callback])
 ```
 
-Производит рендер React элемента внутрь DOM в предоставленный `container` and возвращает [ссылку](/docs/more-about-refs.html) на компонент (или возвращает `null` для [компонентов без состояния](/docs/components-and-props.html#functional-and-class-components)).
+Производит рендер React элемента внутрь DOM в предоставленный `container` и возвращает [ссылку](/docs/more-about-refs.html) на компонент (или возвращает `null` для [компонентов без состояния](/docs/components-and-props.html#functional-and-class-components)).
 
 Если React элемент был предварительно отрендерен в `container`, это произведёт его обновление и мутирует DOM по необходимости для того чтобы отражать последний React элемент.
 
-Если предоставляется дополнительный обратный вызов, он будет выполнен после того, как компонент будет отрендерен или обновлен.
+Если предоставляется дополнительный колбэк, он будет выполнен после того, как компонент будет отрендерен или обновлен.
 
 > Note:
 >
@@ -50,7 +50,7 @@ ReactDOM.render(element, container[, callback])
 >
 > `ReactDOM.render()` в настоящее время возвращает ссылку на корневой экземпляр `ReactComponent`. Однако использование этого возвращаемого значения является устаревшим
 > и этого следует избегать, потому что в будущих версиях React компоненты могут отображаться асинхронно в некоторых случаях. Если вам нужна ссылка на корневой экземпляр `ReactComponent`, предпочтительным решением является прикрепить
-> [callback ref](/docs/more-about-refs.html#the-ref-callback-attribute) к корневому элементу.
+> [ссылку на колбэк](/docs/more-about-refs.html#the-ref-callback-attribute) к корневому элементу.
 >
 > Использование `ReactDOM.render()` для поддержки контейнера отрендеренного на сервере устарел и будет удален в React 17. Используйте [`hydrate()`](#hydrate) вместо этого.
 
@@ -66,9 +66,9 @@ ReactDOM.hydrate(element, container[, callback])
 
 React ожидает, что отображаемый контент идентичен на сервере и клиенте. Он может исправлять различия в текстовом содержимом, но вы должны рассматривать несоответствия как ошибки и исправлять их. В режиме разработки React предупреждает о несоответствиях во время гидратации. Нет никаких гарантий, что различия атрибутов будут исправлены в случае несовпадений. Это важно по соображениям производительности, поскольку в большинстве приложений несоответствия встречаются редко, и поэтому проверка всей разметки будет непомерно дорогой.
 
-Если атрибут отдельного элемента или текстовое содержимое неизбежно отличается между сервером и клиентом (например, отметка времени), вы можете отключить предупреждение, добавив `suppressHydrationWarning={true}` к элементу. Он работает только на один уровень в глубину и предназначен для спасательного люка. Не злоупотребляйте этим. Если это не текстовый контент, React по-прежнему не будет пытаться его исправить, поэтому он может оставаться несовместимым до будущих обновлений.
+Если атрибут отдельного элемента или текстовое содержимое неизбежно отличается на сервере и клиенте (например, отметка времени), вы можете отключить предупреждение, добавив `suppressHydrationWarning={true}` к элементу. Он работает только на один уровень в глубину и является лазейкой. Не злоупотребляйте этим. Если это не текстовый контент, React по-прежнему не будет пытаться его исправить, поэтому он может оставаться несовместимым до будущих обновлений.
 
-Если вам преднамеренно нужно визуализировать что-то другое на сервере и клиенте, вы можете выполнить двухпроходный рендеринг. Компоненты, которые визуализируют что-то другое на клиенте, могут читать переменную состояния, такую как `this.state.isClient`, которую вы можете установить в  `true` в `componentDidMount()`. Таким образом, начальный этап рендеринга будет отображать тот же контент, что и сервер, избегая несовпадений, но дополнительный этап будет происходить синхронно сразу после гидратации. Обратите внимание, что этот подход замедлит ваши компоненты, потому что они должны визуализироваться дважды, поэтому используйте его с осторожностью.
+Если вам преднамеренно нужно визуализировать что-то другое на сервере и клиенте, вы можете выполнить двухпроходный рендеринг. Компоненты, которые визуализируют что-то другое на клиенте, могут читать переменную состояния, такую как `this.state.isClient`, которую вы можете установить в `true` в `componentDidMount()`. Таким образом, начальный этап рендеринга будет отображать тот же контент, что и сервер, избегая несовпадений, но дополнительный этап будет происходить синхронно сразу после гидратации. Обратите внимание, что этот подход замедлит ваши компоненты, потому что они должны визуализироваться дважды, поэтому используйте его с осторожностью.
 
 Помните, что нужно помнить о пользовательском опыте на медленных соединениях. Код JavaScript может загружаться значительно позже исходного HTML-рендеринга, поэтому, если вы рендерите что-то другое только для клиента, переход может вызвать раздражение. Тем не менее, при правильном выполнении может оказаться полезным отобразить «оболочку» приложения на сервере и показать только некоторые дополнительные виджеты на клиенте. Чтобы узнать, как это сделать без проблем с разметкой, обратитесь к объяснению в предыдущем абзаце.
 
@@ -87,12 +87,12 @@ ReactDOM.unmountComponentAtNode(container)
 
 > Заметка:
 >
-> `findDOMNode` это аварийный выход, используемый для доступа к базовому узлу DOM. В большинстве случаев использование этого аварийного люка не рекомендуется, поскольку оно пробивает абстракцию компонента. [Это устарело в `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
+> `findDOMNode` это лазейка, используемая для доступа к базовому узлу DOM. В большинстве случаев использование этой лазейки не рекомендуется, поскольку она пробивает абстракцию компонента. [Это устарело в `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
 
 ```javascript
 ReactDOM.findDOMNode(component)
 ```
-Если этот компонент был смонтирован в DOM, он возвращает соответствующий элемент DOM собственного браузера. Этот метод полезен для чтения значений из DOM, таких как значения полей формы и выполнения измерений DOM. **В большинстве случаев, вы можете присоеденить к реф к узлу DOM и избегать использования `findDOMNode` вовсе.**
+Если этот компонент был смонтирован в DOM, он возвращает соответствующий элемент DOM браузера. Этот метод полезен для чтения значений из DOM, таких как значения полей формы и выполнения измерений DOM. **В большинстве случаев, вы можете присоеденить к реф к узлу DOM и избегать использования `findDOMNode` вовсе.**
 
 Когда компонент рендерится в `null` или` false`, `findDOMNode` возвращает` null`. Когда компонент выполняет рендеринг в строку, `findDOMNode` возвращает текстовый узел DOM, содержащий это значение. Начиная с React 16, компонент может возвращать фрагмент с несколькими дочерними элементами, и в этом случае findDOMNode возвращает узел DOM, соответствующий первому непустому дочернему элементу.
 

From 7e494c9e0e665c11bcf6b59cb03bdf2a80edf1da Mon Sep 17 00:00:00 2001
From: akhudiakov97 <akhudiakov97@gmail.com>
Date: Sat, 16 Feb 2019 15:33:13 +0200
Subject: [PATCH 03/17] react-dom-translation-v3
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Вот, исправил все замечания, и заметил несколько новых ошибок, готов исправить ещё, если будет необходимость )
---
 content/docs/reference-react-dom.md | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index b81026f92..c5a010544 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -8,7 +8,7 @@ permalink: docs/react-dom.html
 
 Если вы загружаете React с помощью тэга `<script>`, эти высокоуровневые API доступны через глобальный `ReactDOM`. Если вы используете ES6 с npm, вы можете написать `import ReactDOM from 'react-dom'`.Если вы используете ES5 с npm, вы можете написать `var ReactDOM = require('react-dom')`.
 
-## Обзор
+## Обзор {#overview}
 
 Пакет `react-dom` предостваляет специфические DOM методы которые могут быть использованы на верхнем уровне вашего приложения и как лазейка для того чтобы выйти из модели React если вам будет нужно. Большинство из ваших компонентов не должны использовать этот модуль
 
@@ -18,7 +18,7 @@ permalink: docs/react-dom.html
 - [`findDOMNode()`](#finddomnode)
 - [`createPortal()`](#createportal)
 
-### Поддержка Браузерами
+### Поддержка браузерами {#browser-support}
 
 React поддерживает все популярные браузеры, включая Internet Explorer 9 and выше, хотя [иногда вам понадобятся некоторые полифиллы](/docs/javascript-environment-requirements.html) для более старых браузеров, например IE 9 или IE 10.
 
@@ -28,7 +28,7 @@ React поддерживает все популярные браузеры, в
 
 * * *
 
-## Ссылка
+## Справочник {#browser-support}
 
 ### `render()`
 
@@ -42,7 +42,7 @@ ReactDOM.render(element, container[, callback])
 
 Если предоставляется дополнительный колбэк, он будет выполнен после того, как компонент будет отрендерен или обновлен.
 
-> Note:
+> Примечание:
 >
 > `ReactDOM.render()` управляет содержимым передаваемого вами узла контейнера. Любые существующие элементы DOM внутри заменяются при первом вызове. Более поздние вызовы используют алгоритм отслеживания изменений React DOM для эффективного обновления.
 >
@@ -56,7 +56,7 @@ ReactDOM.render(element, container[, callback])
 
 * * *
 
-### `hydrate()`
+### `hydrate()` {#hydrate}
 
 ```javascript
 ReactDOM.hydrate(element, container[, callback])
@@ -68,24 +68,24 @@ React ожидает, что отображаемый контент идент
 
 Если атрибут отдельного элемента или текстовое содержимое неизбежно отличается на сервере и клиенте (например, отметка времени), вы можете отключить предупреждение, добавив `suppressHydrationWarning={true}` к элементу. Он работает только на один уровень в глубину и является лазейкой. Не злоупотребляйте этим. Если это не текстовый контент, React по-прежнему не будет пытаться его исправить, поэтому он может оставаться несовместимым до будущих обновлений.
 
-Если вам преднамеренно нужно визуализировать что-то другое на сервере и клиенте, вы можете выполнить двухпроходный рендеринг. Компоненты, которые визуализируют что-то другое на клиенте, могут читать переменную состояния, такую как `this.state.isClient`, которую вы можете установить в `true` в `componentDidMount()`. Таким образом, начальный этап рендеринга будет отображать тот же контент, что и сервер, избегая несовпадений, но дополнительный этап будет происходить синхронно сразу после гидратации. Обратите внимание, что этот подход замедлит ваши компоненты, потому что они должны визуализироваться дважды, поэтому используйте его с осторожностью.
+Если вам преднамеренно нужно отрендерить что-то другое на сервере и клиенте, вы можете выполнить двухпроходный рендеринг. Компоненты, которые рендерят что-то другое на клиенте, могут читать переменную состояния, такую как `this.state.isClient`, которую вы можете установить в `true` в `componentDidMount()`. Таким образом, начальный этап рендеринга будет отображать тот же контент, что и сервер, избегая несовпадений, но дополнительный этап будет происходить синхронно сразу после гидратации. Обратите внимание, что этот подход замедлит ваши компоненты, потому что они должны рендерится дважды, поэтому используйте его с осторожностью.
 
 Помните, что нужно помнить о пользовательском опыте на медленных соединениях. Код JavaScript может загружаться значительно позже исходного HTML-рендеринга, поэтому, если вы рендерите что-то другое только для клиента, переход может вызвать раздражение. Тем не менее, при правильном выполнении может оказаться полезным отобразить «оболочку» приложения на сервере и показать только некоторые дополнительные виджеты на клиенте. Чтобы узнать, как это сделать без проблем с разметкой, обратитесь к объяснению в предыдущем абзаце.
 
 * * *
 
-### `unmountComponentAtNode()`
+### `unmountComponentAtNode()` {#unmountcomponentatnode}
 
 ```javascript
 ReactDOM.unmountComponentAtNode(container)
 ```
 
-Удалите смонтированный компонент React из DOM и очистите его обработчики событий и состояние. Если в контейнере не было смонтировано ни одного компонента, вызов этой функции ничего не делает. Возвращает `true` если компонент был размонтированand `false` если не было компонента для размонтирования.
+Удалите смонтированный компонент React из DOM и очистите его обработчики событий и состояние. Если в контейнере не было смонтировано ни одного компонента, вызов этой функции ничего не делает. Возвращает `true` если компонент был размонтирован и `false` если не было компонента для размонтирования.
 * * *
 
-### `findDOMNode()`
+### `findDOMNode()`  {#finddomnode}
 
-> Заметка:
+> Примечание:
 >
 > `findDOMNode` это лазейка, используемая для доступа к базовому узлу DOM. В большинстве случаев использование этой лазейки не рекомендуется, поскольку она пробивает абстракцию компонента. [Это устарело в `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
 
@@ -96,15 +96,15 @@ ReactDOM.findDOMNode(component)
 
 Когда компонент рендерится в `null` или` false`, `findDOMNode` возвращает` null`. Когда компонент выполняет рендеринг в строку, `findDOMNode` возвращает текстовый узел DOM, содержащий это значение. Начиная с React 16, компонент может возвращать фрагмент с несколькими дочерними элементами, и в этом случае findDOMNode возвращает узел DOM, соответствующий первому непустому дочернему элементу.
 
-> Заметка:
+> Примечание:
 >
-> `findDOMNode` работает только с подключенными компонентами (то есть компонентами, которые были размещены в DOM). Если вы попытаетесь вызвать это для компонента, который еще не был смонтирован (например, вызов `findDOMNode ()` в `render ()` для компонента, который еще не создан), будет сгенерировано исключение.
+> `findDOMNode` работает только с монтированными компонентами (то есть компонентами, которые были размещены в DOM). Если вы попытаетесь вызвать это для компонента, который еще не был смонтирован (например, вызов `findDOMNode ()` в `render ()` для компонента, который еще не создан), будет сгенерировано исключение.
 >
-> `findDOMNode` не может использоваться с функциональными компонентами.
+> `findDOMNode` не может быть использован с функциональными компонентами.
 
 * * *
 
-### `createPortal()`
+### `createPortal()` {#createportal}
 
 ```javascript
 ReactDOM.createPortal(child, container)

From 93b9827089573bd16bec9c7f05b034dbcc059109 Mon Sep 17 00:00:00 2001
From: akhudiakov97 <akhudiakov97@gmail.com>
Date: Sat, 16 Feb 2019 15:33:24 +0200
Subject: [PATCH 04/17] react-dom-translation-v3
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Вот, исправил все замечания, и заметил несколько новых ошибок, готов исправить ещё, если будет необходимость )

From 9018406951f60006315cddbda070d65790e11a9a Mon Sep 17 00:00:00 2001
From: akhudiakov97 <akhudiakov97@gmail.com>
Date: Sat, 16 Feb 2019 15:34:40 +0200
Subject: [PATCH 05/17] React-Dom-translation-v4

---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index c5a010544..4b4c715d5 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -110,4 +110,4 @@ ReactDOM.findDOMNode(component)
 ReactDOM.createPortal(child, container)
 ```
 
-Создает портал. Порталы предоставляют способ [визуализировать дочерние элементы в узле DOM, который существует вне иерархии компонента DOM](/docs/portals.html).
+Создает портал. Порталы предоставляют способ [отрендерить дочерние элементы в узле DOM, который существует вне иерархии компонента DOM](/docs/portals.html).

From baca138af7ca4df96e98466c5468b6c15ae516d1 Mon Sep 17 00:00:00 2001
From: akhudiakov97 <akhudiakov97@gmail.com>
Date: Sat, 16 Feb 2019 15:34:48 +0200
Subject: [PATCH 06/17] React-Dom-translation-v4


From 1aecd8320496271147dbbf12178e18d16b0b9c92 Mon Sep 17 00:00:00 2001
From: akhudiakov97 <akhudiakov97@gmail.com>
Date: Wed, 20 Feb 2019 20:23:09 +0200
Subject: [PATCH 07/17] React_Dom_translation_last_paragraphs_adjustments
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Надеюсь стало лучше
---
 content/docs/reference-react-dom.md | 32 ++++++++++++++---------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 4b4c715d5..069acaf6f 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -6,11 +6,11 @@ category: Reference
 permalink: docs/react-dom.html
 ---
 
-Если вы загружаете React с помощью тэга `<script>`, эти высокоуровневые API доступны через глобальный `ReactDOM`. Если вы используете ES6 с npm, вы можете написать `import ReactDOM from 'react-dom'`.Если вы используете ES5 с npm, вы можете написать `var ReactDOM = require('react-dom')`.
+Если вы загружаете React с помощью тега `<script>`, перечисленные ниже высокоуровневые API-методы доступны через глобальный `ReactDOM`. Если вы используете ES6 с npm, можете написать `import ReactDOM from 'react-dom'`, а в случае ES5 с npm — `var ReactDOM = require('react-dom')`.
 
 ## Обзор {#overview}
 
-Пакет `react-dom` предостваляет специфические DOM методы которые могут быть использованы на верхнем уровне вашего приложения и как лазейка для того чтобы выйти из модели React если вам будет нужно. Большинство из ваших компонентов не должны использовать этот модуль
+Пакет `react-dom` предоставляет специфические для DOM методы, которые могут быть использованы на верхнем уровне вашего приложения. Кроме этого, эти методы можно использовать в качестве лазейки, чтобы выйти из модели React, если вам будет это нужно. Поэтому большинство из ваших компонентов не должны использовать этот модуль.
 
 - [`render()`](#render)
 - [`hydrate()`](#hydrate)
@@ -20,11 +20,11 @@ permalink: docs/react-dom.html
 
 ### Поддержка браузерами {#browser-support}
 
-React поддерживает все популярные браузеры, включая Internet Explorer 9 and выше, хотя [иногда вам понадобятся некоторые полифиллы](/docs/javascript-environment-requirements.html) для более старых браузеров, например IE 9 или IE 10.
+React поддерживает все популярные браузеры, включая Internet Explorer 9 и выше, хотя [ понадобятся полифилы](/docs/javascript-environment-requirements.html) для более старых браузеров, например, IE 9 или IE 10.
 
 > Note
 >
-> Мы не поддерживаем более старые браузеры, которые не поддерживают ES5 методы, но вы можете обнаружить, что ваши программы работают в более старых браузерах если полифиллы вроде [es5-shim and es5-sham](https://github.com/es-shims/es5-shim) уже присутствуют на странице. Вы будете сами по себе, если решите пойти этой дорогой.
+> Мы не поддерживаем старые браузеры, в которых отсутствуют ES5-методы, но чтобы обеспечить работу ваших приложений в старых браузерах вы можете подключить шимы [es5-shim и es5-sham](https://github.com/es-shims/es5-shim). Но учтите, мы не сможем вам помочь, если вы предпочтёте сделать это.
 
 * * *
 
@@ -36,7 +36,7 @@ React поддерживает все популярные браузеры, в
 ReactDOM.render(element, container[, callback])
 ```
 
-Производит рендер React элемента внутрь DOM в предоставленный `container` и возвращает [ссылку](/docs/more-about-refs.html) на компонент (или возвращает `null` для [компонентов без состояния](/docs/components-and-props.html#functional-and-class-components)).
+Рендерит React-элемент в DOM-элемент, переданный в аргумент `container` и возвращает [ссылку](/docs/more-about-refs.html) на компонент (или возвращает `null` для [компонентов без состояния](/docs/components-and-props.html#functional-and-class-components)).
 
 Если React элемент был предварительно отрендерен в `container`, это произведёт его обновление и мутирует DOM по необходимости для того чтобы отражать последний React элемент.
 
@@ -52,7 +52,7 @@ ReactDOM.render(element, container[, callback])
 > и этого следует избегать, потому что в будущих версиях React компоненты могут отображаться асинхронно в некоторых случаях. Если вам нужна ссылка на корневой экземпляр `ReactComponent`, предпочтительным решением является прикрепить
 > [ссылку на колбэк](/docs/more-about-refs.html#the-ref-callback-attribute) к корневому элементу.
 >
-> Использование `ReactDOM.render()` для поддержки контейнера отрендеренного на сервере устарел и будет удален в React 17. Используйте [`hydrate()`](#hydrate) вместо этого.
+> Использование `ReactDOM.render()` для гидратации контейнера, отрендеренного на сервере, объявлено устаревшим и будет удалено в React 17. Вместо этого используйте метод [`hydrate()`](#hydrate).
 
 * * *
 
@@ -62,15 +62,15 @@ ReactDOM.render(element, container[, callback])
 ReactDOM.hydrate(element, container[, callback])
 ```
 
-Тоже что и [`render()`](#render), но используется для гидратации контейнера, содержимое HTML которого было отрендеренного [`ReactDOMServer`](/docs/react-dom-server.html). React попытается присоединить прослушиватели событий к существующей разметке.
+о же что и [`render()`](#render), но используется для гидратации контейнера, HTML-содержимое которого было отрендеренного с помощью [`ReactDOMServer`](/docs/react-dom-server.html). React попытается присоединить обработки событий к существующей разметке.
 
-React ожидает, что отображаемый контент идентичен на сервере и клиенте. Он может исправлять различия в текстовом содержимом, но вы должны рассматривать несоответствия как ошибки и исправлять их. В режиме разработки React предупреждает о несоответствиях во время гидратации. Нет никаких гарантий, что различия атрибутов будут исправлены в случае несовпадений. Это важно по соображениям производительности, поскольку в большинстве приложений несоответствия встречаются редко, и поэтому проверка всей разметки будет непомерно дорогой.
+React ожидает, что отрендеренное содержимое идентично на сервере, и на клиенте. Он может исправлять различия в текстовом содержимом, но вам следует рассматривать несоответствия как ошибки и исправлять их. В режиме разработки React предупреждает о несоответствиях во время гидратации. Нет никаких гарантий, что различия атрибутов будут исправлены в случае несовпадений. Это важно по соображениям производительности, поскольку в большинстве приложений несоответствия встречаются редко, и поэтому проверка всей разметки будет непомерно дорогой.
 
-Если атрибут отдельного элемента или текстовое содержимое неизбежно отличается на сервере и клиенте (например, отметка времени), вы можете отключить предупреждение, добавив `suppressHydrationWarning={true}` к элементу. Он работает только на один уровень в глубину и является лазейкой. Не злоупотребляйте этим. Если это не текстовый контент, React по-прежнему не будет пытаться его исправить, поэтому он может оставаться несовместимым до будущих обновлений.
+Если атрибут отдельного элемента или текстовое содержимое неизбежно отличается на сервере и клиенте (например, отметка времени), вы можете отключить предупреждение, добавив к элементу `suppressHydrationWarning={true}`. Он работает только на один уровень в глубину, и задумана как лазейка. Не злоупотребляйте ею. Если это не текстовый контент, React по-прежнему не будет пытаться его исправить, поэтому он может оставаться несовместимым до будущих обновлений.
 
 Если вам преднамеренно нужно отрендерить что-то другое на сервере и клиенте, вы можете выполнить двухпроходный рендеринг. Компоненты, которые рендерят что-то другое на клиенте, могут читать переменную состояния, такую как `this.state.isClient`, которую вы можете установить в `true` в `componentDidMount()`. Таким образом, начальный этап рендеринга будет отображать тот же контент, что и сервер, избегая несовпадений, но дополнительный этап будет происходить синхронно сразу после гидратации. Обратите внимание, что этот подход замедлит ваши компоненты, потому что они должны рендерится дважды, поэтому используйте его с осторожностью.
 
-Помните, что нужно помнить о пользовательском опыте на медленных соединениях. Код JavaScript может загружаться значительно позже исходного HTML-рендеринга, поэтому, если вы рендерите что-то другое только для клиента, переход может вызвать раздражение. Тем не менее, при правильном выполнении может оказаться полезным отобразить «оболочку» приложения на сервере и показать только некоторые дополнительные виджеты на клиенте. Чтобы узнать, как это сделать без проблем с разметкой, обратитесь к объяснению в предыдущем абзаце.
+Не забывайте про работу с вашим приложением при медленных соединениях. JavaScript-код может загружаться значительно позже исходного HTML-рендеринга, поэтому, если вы рендерите что-то другое только для клиента, переход может вызвать раздражение. Тем не менее, при правильном выполнении может оказаться полезным отобразить «оболочку» приложения на сервере и показать только некоторые дополнительные виджеты на клиенте. Чтобы узнать, как это сделать без проблем с разметкой, обратитесь к объяснению в предыдущем абзаце.
 
 * * *
 
@@ -80,25 +80,25 @@ React ожидает, что отображаемый контент идент
 ReactDOM.unmountComponentAtNode(container)
 ```
 
-Удалите смонтированный компонент React из DOM и очистите его обработчики событий и состояние. Если в контейнере не было смонтировано ни одного компонента, вызов этой функции ничего не делает. Возвращает `true` если компонент был размонтирован и `false` если не было компонента для размонтирования.
+Удалите смотированный компонент React из DOM и очистите его обработчики событий и состояние. Если в контейнер не было смотировано ни одного компонента, вызов этой функции ничего не делает. Возвращает `true` если компонент был размонтирован и `false` если не было компонента для размонтирования.
 * * *
 
 ### `findDOMNode()`  {#finddomnode}
 
 > Примечание:
 >
-> `findDOMNode` это лазейка, используемая для доступа к базовому узлу DOM. В большинстве случаев использование этой лазейки не рекомендуется, поскольку она пробивает абстракцию компонента. [Это устарело в `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
+> `findDOMNode` это лазейка, используемая для доступа к базовому узлу DOM. В большинстве случаев использование этого метода не рекомендуется, поскольку он пробивает абстракцию компонента. [Метод устарел в `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
 
 ```javascript
 ReactDOM.findDOMNode(component)
 ```
-Если этот компонент был смонтирован в DOM, он возвращает соответствующий элемент DOM браузера. Этот метод полезен для чтения значений из DOM, таких как значения полей формы и выполнения измерений DOM. **В большинстве случаев, вы можете присоеденить к реф к узлу DOM и избегать использования `findDOMNode` вовсе.**
+Если этот компонент был смотирован в DOM, он возвращает соответствующий DOM элемент браузера. Этот метод полезен для чтения значений из DOM, таких как значения полей формы, и произведения измерений DOM. **В большинстве случаев, вы можете присоеденить реф к узлу DOM и совсем избежать использования `findDOMNode`.** 
 
-Когда компонент рендерится в `null` или` false`, `findDOMNode` возвращает` null`. Когда компонент выполняет рендеринг в строку, `findDOMNode` возвращает текстовый узел DOM, содержащий это значение. Начиная с React 16, компонент может возвращать фрагмент с несколькими дочерними элементами, и в этом случае findDOMNode возвращает узел DOM, соответствующий первому непустому дочернему элементу.
+Когда компонент рендерится в `null` или` false`, `findDOMNode` возвращает` null`. Когда компонент рендерится в строку, `findDOMNode` возвращает текстовый узел DOM, содержащий это значение. Начиная с React 16, компонент может возвращать фрагмент с несколькими дочерними элементами, и в этом случае findDOMNode возвращает узел DOM, соответствующий первому непустому дочернему элементу.
 
 > Примечание:
 >
-> `findDOMNode` работает только с монтированными компонентами (то есть компонентами, которые были размещены в DOM). Если вы попытаетесь вызвать это для компонента, который еще не был смонтирован (например, вызов `findDOMNode ()` в `render ()` для компонента, который еще не создан), будет сгенерировано исключение.
+> `findDOMNode` работает только с смотированными компонентами (то есть компонентами, которые были размещены в DOM). Если вы попытаетесь вызвать этот метод для компонента, который еще не был смонтирован (например, вызовете `findDOMNode ()` в методе `render ()` для компонента, который еще не был создан), будет сгенерировано исключение.
 >
 > `findDOMNode` не может быть использован с функциональными компонентами.
 
@@ -110,4 +110,4 @@ ReactDOM.findDOMNode(component)
 ReactDOM.createPortal(child, container)
 ```
 
-Создает портал. Порталы предоставляют способ [отрендерить дочерние элементы в узле DOM, который существует вне иерархии компонента DOM](/docs/portals.html).
+Создает портал. Порталы предоставляют способ [отрендерить дочерние элементы в узле DOM, который существует вне иерархии DOM компонента](/docs/portals.html).

From c5a6edb19b4d7a11c556220da67c21a150232d41 Mon Sep 17 00:00:00 2001
From: Alexey Pyltsyn <lex61rus@gmail.com>
Date: Thu, 28 Feb 2019 12:21:15 +0200
Subject: [PATCH 08/17] Update content/docs/reference-react-dom.md

Co-Authored-By: akhudiakov97 <akhudiakov97@gmail.com>
---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 069acaf6f..511857c9d 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -110,4 +110,4 @@ ReactDOM.findDOMNode(component)
 ReactDOM.createPortal(child, container)
 ```
 
-Создает портал. Порталы предоставляют способ [отрендерить дочерние элементы в узле DOM, который существует вне иерархии DOM компонента](/docs/portals.html).
+Создает портал. Порталы предоставляют способ [отрендерить дочерние элементы в узле DOM, который существует вне иерархии DOM-компонента](/docs/portals.html).

From d07e3e707cc1d3613a1814fe916aca48fdc481fa Mon Sep 17 00:00:00 2001
From: Alexey Pyltsyn <lex61rus@gmail.com>
Date: Thu, 28 Feb 2019 12:21:31 +0200
Subject: [PATCH 09/17] Update content/docs/reference-react-dom.md

Co-Authored-By: akhudiakov97 <akhudiakov97@gmail.com>
---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 511857c9d..94365f1d9 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -22,7 +22,7 @@ permalink: docs/react-dom.html
 
 React поддерживает все популярные браузеры, включая Internet Explorer 9 и выше, хотя [ понадобятся полифилы](/docs/javascript-environment-requirements.html) для более старых браузеров, например, IE 9 или IE 10.
 
-> Note
+> Примечание
 >
 > Мы не поддерживаем старые браузеры, в которых отсутствуют ES5-методы, но чтобы обеспечить работу ваших приложений в старых браузерах вы можете подключить шимы [es5-shim и es5-sham](https://github.com/es-shims/es5-shim). Но учтите, мы не сможем вам помочь, если вы предпочтёте сделать это.
 

From 0b063e56ddf6a5749deae5e2372581e5ead978b7 Mon Sep 17 00:00:00 2001
From: Alexey Pyltsyn <lex61rus@gmail.com>
Date: Thu, 28 Feb 2019 12:21:40 +0200
Subject: [PATCH 10/17] Update content/docs/reference-react-dom.md

Co-Authored-By: akhudiakov97 <akhudiakov97@gmail.com>
---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 94365f1d9..12fa63710 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -38,7 +38,7 @@ ReactDOM.render(element, container[, callback])
 
 Рендерит React-элемент в DOM-элемент, переданный в аргумент `container` и возвращает [ссылку](/docs/more-about-refs.html) на компонент (или возвращает `null` для [компонентов без состояния](/docs/components-and-props.html#functional-and-class-components)).
 
-Если React элемент был предварительно отрендерен в `container`, это произведёт его обновление и мутирует DOM по необходимости для того чтобы отражать последний React элемент.
+Если React-элемент ранее был отрендерен в `container`, то повторный вызов произведёт его обновление и изменит соответствующую часть DOM, чтобы она содержала последние изменения.
 
 Если предоставляется дополнительный колбэк, он будет выполнен после того, как компонент будет отрендерен или обновлен.
 

From 414e6ee0180364810fa106e928cd0d5a0ca886f3 Mon Sep 17 00:00:00 2001
From: Alexey Pyltsyn <lex61rus@gmail.com>
Date: Thu, 28 Feb 2019 12:21:47 +0200
Subject: [PATCH 11/17] Update content/docs/reference-react-dom.md

Co-Authored-By: akhudiakov97 <akhudiakov97@gmail.com>
---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 12fa63710..9b4e19a8d 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -62,7 +62,7 @@ ReactDOM.render(element, container[, callback])
 ReactDOM.hydrate(element, container[, callback])
 ```
 
-о же что и [`render()`](#render), но используется для гидратации контейнера, HTML-содержимое которого было отрендеренного с помощью [`ReactDOMServer`](/docs/react-dom-server.html). React попытается присоединить обработки событий к существующей разметке.
+То же, что и [`render()`](#render), но используется для гидратации контейнера, HTML-содержимое которого было отрендеренного с помощью [`ReactDOMServer`](/docs/react-dom-server.html). React попытается присоединить обработки событий к существующей разметке.
 
 React ожидает, что отрендеренное содержимое идентично на сервере, и на клиенте. Он может исправлять различия в текстовом содержимом, но вам следует рассматривать несоответствия как ошибки и исправлять их. В режиме разработки React предупреждает о несоответствиях во время гидратации. Нет никаких гарантий, что различия атрибутов будут исправлены в случае несовпадений. Это важно по соображениям производительности, поскольку в большинстве приложений несоответствия встречаются редко, и поэтому проверка всей разметки будет непомерно дорогой.
 

From eeb8ecd95430e23cc8daab1b0328b0f27eca7a97 Mon Sep 17 00:00:00 2001
From: Alexey Pyltsyn <lex61rus@gmail.com>
Date: Thu, 28 Feb 2019 12:21:55 +0200
Subject: [PATCH 12/17] Update content/docs/reference-react-dom.md

Co-Authored-By: akhudiakov97 <akhudiakov97@gmail.com>
---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 9b4e19a8d..30026acd4 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -80,7 +80,7 @@ React ожидает, что отрендеренное содержимое и
 ReactDOM.unmountComponentAtNode(container)
 ```
 
-Удалите смотированный компонент React из DOM и очистите его обработчики событий и состояние. Если в контейнер не было смотировано ни одного компонента, вызов этой функции ничего не делает. Возвращает `true` если компонент был размонтирован и `false` если не было компонента для размонтирования.
+Удалите смотированный компонент React из DOM и очистите его обработчики событий и состояние. Если в контейнер не было смотировано ни одного компонента, вызов этой функции ничего не делает. Возвращает `true`, если компонент был размонтирован, и `false` если нет компонента для размонтирования.
 * * *
 
 ### `findDOMNode()`  {#finddomnode}

From 724d604aeb6de0bf64b925fe069927cc8daae011 Mon Sep 17 00:00:00 2001
From: Alexey Pyltsyn <lex61rus@gmail.com>
Date: Thu, 28 Feb 2019 12:22:08 +0200
Subject: [PATCH 13/17] Update content/docs/reference-react-dom.md

Co-Authored-By: akhudiakov97 <akhudiakov97@gmail.com>
---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 30026acd4..76810bf7f 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -87,7 +87,7 @@ ReactDOM.unmountComponentAtNode(container)
 
 > Примечание:
 >
-> `findDOMNode` это лазейка, используемая для доступа к базовому узлу DOM. В большинстве случаев использование этого метода не рекомендуется, поскольку он пробивает абстракцию компонента. [Метод устарел в `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
+> `findDOMNode` — это лазейка, используемая для доступа к базовому узлу DOM. В большинстве случаев использование этого метода не рекомендуется, поскольку он пробивает абстракцию компонента. [Метод устарел в `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
 
 ```javascript
 ReactDOM.findDOMNode(component)

From 750128a0284381a35247320e8c762d1968dc65b3 Mon Sep 17 00:00:00 2001
From: Alexey Pyltsyn <lex61rus@gmail.com>
Date: Thu, 28 Feb 2019 12:22:15 +0200
Subject: [PATCH 14/17] Update content/docs/reference-react-dom.md

Co-Authored-By: akhudiakov97 <akhudiakov97@gmail.com>
---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 76810bf7f..7965fbe05 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -83,7 +83,7 @@ ReactDOM.unmountComponentAtNode(container)
 Удалите смотированный компонент React из DOM и очистите его обработчики событий и состояние. Если в контейнер не было смотировано ни одного компонента, вызов этой функции ничего не делает. Возвращает `true`, если компонент был размонтирован, и `false` если нет компонента для размонтирования.
 * * *
 
-### `findDOMNode()`  {#finddomnode}
+### `findDOMNode()` {#finddomnode}
 
 > Примечание:
 >

From ac69097126c01dd876f912204ca9240240214c3f Mon Sep 17 00:00:00 2001
From: Alexey Pyltsyn <lex61rus@gmail.com>
Date: Thu, 28 Feb 2019 12:22:22 +0200
Subject: [PATCH 15/17] Update content/docs/reference-react-dom.md

Co-Authored-By: akhudiakov97 <akhudiakov97@gmail.com>
---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 7965fbe05..cd799bbfc 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -94,7 +94,7 @@ ReactDOM.findDOMNode(component)
 ```
 Если этот компонент был смотирован в DOM, он возвращает соответствующий DOM элемент браузера. Этот метод полезен для чтения значений из DOM, таких как значения полей формы, и произведения измерений DOM. **В большинстве случаев, вы можете присоеденить реф к узлу DOM и совсем избежать использования `findDOMNode`.** 
 
-Когда компонент рендерится в `null` или` false`, `findDOMNode` возвращает` null`. Когда компонент рендерится в строку, `findDOMNode` возвращает текстовый узел DOM, содержащий это значение. Начиная с React 16, компонент может возвращать фрагмент с несколькими дочерними элементами, и в этом случае findDOMNode возвращает узел DOM, соответствующий первому непустому дочернему элементу.
+Когда компонент рендерится в `null` или `false`, `findDOMNode` возвращает `null`. Когда компонент рендерится в строку, `findDOMNode` возвращает текстовый узел DOM, содержащий это значение. Начиная с React 16, компонент может возвращать фрагмент с несколькими дочерними элементами, и в этом случае `findDOMNode` возвращает DOM-узел, соответствующий первому непустому дочернему элементу.
 
 > Примечание:
 >

From d2d7dd75094c4de591162008f2bf8af59dd78a65 Mon Sep 17 00:00:00 2001
From: Alexey Pyltsyn <lex61rus@gmail.com>
Date: Thu, 28 Feb 2019 12:22:30 +0200
Subject: [PATCH 16/17] Update content/docs/reference-react-dom.md

Co-Authored-By: akhudiakov97 <akhudiakov97@gmail.com>
---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index cd799bbfc..6a00da51f 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -98,7 +98,7 @@ ReactDOM.findDOMNode(component)
 
 > Примечание:
 >
-> `findDOMNode` работает только с смотированными компонентами (то есть компонентами, которые были размещены в DOM). Если вы попытаетесь вызвать этот метод для компонента, который еще не был смонтирован (например, вызовете `findDOMNode ()` в методе `render ()` для компонента, который еще не был создан), будет сгенерировано исключение.
+> `findDOMNode` работает только с смотированными компонентами (то есть компонентами, которые были размещены в DOM). Если вы попытаетесь вызвать этот метод для компонента, который еще не был смонтирован (например, вызовете `findDOMNode()` в методе `render()` для компонента, который еще не был создан), будет сгенерировано исключение.
 >
 > `findDOMNode` не может быть использован с функциональными компонентами.
 

From f8e5b2ca7547368595280b11852611b4acc9fdac Mon Sep 17 00:00:00 2001
From: ANOTHER GUY <another-guy@users.noreply.github.com>
Date: Fri, 1 Mar 2019 09:40:55 -0800
Subject: [PATCH 17/17] Update reference-react-dom.md

---
 content/docs/reference-react-dom.md | 31 +++++++++++++++--------------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 6a00da51f..1589b59ba 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -6,7 +6,7 @@ category: Reference
 permalink: docs/react-dom.html
 ---
 
-Если вы загружаете React с помощью тега `<script>`, перечисленные ниже высокоуровневые API-методы доступны через глобальный `ReactDOM`. Если вы используете ES6 с npm, можете написать `import ReactDOM from 'react-dom'`, а в случае ES5 с npm — `var ReactDOM = require('react-dom')`.
+Когда вы загружаете React с помощью тега `<script>`, глобальный `ReactDOM` предоставляет вам доступ к высокоуровневым API-методам. Если вы используете ES6 с npm, можете написать `import ReactDOM from 'react-dom'`, а в случае ES5 с npm — `var ReactDOM = require('react-dom')`.
 
 ## Обзор {#overview}
 
@@ -20,11 +20,11 @@ permalink: docs/react-dom.html
 
 ### Поддержка браузерами {#browser-support}
 
-React поддерживает все популярные браузеры, включая Internet Explorer 9 и выше, хотя [ понадобятся полифилы](/docs/javascript-environment-requirements.html) для более старых браузеров, например, IE 9 или IE 10.
+React поддерживает все популярные браузеры, включая Internet Explorer 9 и выше, хотя [понадобятся полифилы](/docs/javascript-environment-requirements.html) для более старых браузеров, например, IE 9 или IE 10.
 
 > Примечание
 >
-> Мы не поддерживаем старые браузеры, в которых отсутствуют ES5-методы, но чтобы обеспечить работу ваших приложений в старых браузерах вы можете подключить шимы [es5-shim и es5-sham](https://github.com/es-shims/es5-shim). Но учтите, мы не сможем вам помочь, если вы предпочтёте сделать это.
+> Мы не поддерживаем старые браузеры, в которых отсутствуют ES5-методы. Возможно, вам удастся обойти эту проблему старых браузеров, если вы подключите шимы [es5-shim и es5-sham](https://github.com/es-shims/es5-shim). Пожалуйста учтите, что этот путь официально не поддерживается и вы принимаете решение на свой страх и риск.
 
 * * *
 
@@ -38,19 +38,19 @@ ReactDOM.render(element, container[, callback])
 
 Рендерит React-элемент в DOM-элемент, переданный в аргумент `container` и возвращает [ссылку](/docs/more-about-refs.html) на компонент (или возвращает `null` для [компонентов без состояния](/docs/components-and-props.html#functional-and-class-components)).
 
-Если React-элемент ранее был отрендерен в `container`, то повторный вызов произведёт его обновление и изменит соответствующую часть DOM, чтобы она содержала последние изменения.
+Если React-элемент уже был ранее отрендерен в `container`, то повторный вызов произведёт его обновление и изменит соответствующую часть DOM, чтобы она содержала последние изменения.
 
-Если предоставляется дополнительный колбэк, он будет выполнен после того, как компонент будет отрендерен или обновлен.
+Если дополнительно был предоставлен колбэк, он будет вызван после того, как компонент отрендерится или обновится.
 
 > Примечание:
 >
 > `ReactDOM.render()` управляет содержимым передаваемого вами узла контейнера. Любые существующие элементы DOM внутри заменяются при первом вызове. Более поздние вызовы используют алгоритм отслеживания изменений React DOM для эффективного обновления.
 >
-> `ReactDOM.render()` не изменяет узел контейнера (изменяет только дочерние элементы контейнера). Возможно вставить компонент в существующий узел DOM без перезаписи существующих дочерних элементов.
+> `ReactDOM.render()` не изменяет узел контейнера (изменяет только дочерние элементы контейнера). Если нужно, можно вставить компонент в существующий узел DOM без перезаписи существующих дочерних элементов.
 >
 > `ReactDOM.render()` в настоящее время возвращает ссылку на корневой экземпляр `ReactComponent`. Однако использование этого возвращаемого значения является устаревшим
 > и этого следует избегать, потому что в будущих версиях React компоненты могут отображаться асинхронно в некоторых случаях. Если вам нужна ссылка на корневой экземпляр `ReactComponent`, предпочтительным решением является прикрепить
-> [ссылку на колбэк](/docs/more-about-refs.html#the-ref-callback-attribute) к корневому элементу.
+> [реф (ref) на колбэк](/docs/more-about-refs.html#the-ref-callback-attribute) к корневому элементу.
 >
 > Использование `ReactDOM.render()` для гидратации контейнера, отрендеренного на сервере, объявлено устаревшим и будет удалено в React 17. Вместо этого используйте метод [`hydrate()`](#hydrate).
 
@@ -62,13 +62,13 @@ ReactDOM.render(element, container[, callback])
 ReactDOM.hydrate(element, container[, callback])
 ```
 
-То же, что и [`render()`](#render), но используется для гидратации контейнера, HTML-содержимое которого было отрендеренного с помощью [`ReactDOMServer`](/docs/react-dom-server.html). React попытается присоединить обработки событий к существующей разметке.
+То же, что и [`render()`](#render), но используется для гидратации контейнера, HTML-содержимое которого было отрендеренно с помощью [`ReactDOMServer`](/docs/react-dom-server.html). React попытается присоединить обработчики событий к уже существующей разметке.
 
-React ожидает, что отрендеренное содержимое идентично на сервере, и на клиенте. Он может исправлять различия в текстовом содержимом, но вам следует рассматривать несоответствия как ошибки и исправлять их. В режиме разработки React предупреждает о несоответствиях во время гидратации. Нет никаких гарантий, что различия атрибутов будут исправлены в случае несовпадений. Это важно по соображениям производительности, поскольку в большинстве приложений несоответствия встречаются редко, и поэтому проверка всей разметки будет непомерно дорогой.
+React ожидает, что отрендеренное содержимое идентично на сервере, и на клиенте. Текстовые различия в контенте могут быть переписаны поверх, но вам следует рассматривать такие нестыковки как ошибки и исправлять их. В режиме разработки React предупреждает о несоответствиях во время гидратации. Нет никаких гарантий, что различия атрибутов будут исправлены в случае несовпадений. Это важно по соображениям производительности, поскольку в большинстве приложений несоответствия встречаются редко, и поэтому проверка всей разметки будет непомерно дорогой.
 
-Если атрибут отдельного элемента или текстовое содержимое неизбежно отличается на сервере и клиенте (например, отметка времени), вы можете отключить предупреждение, добавив к элементу `suppressHydrationWarning={true}`. Он работает только на один уровень в глубину, и задумана как лазейка. Не злоупотребляйте ею. Если это не текстовый контент, React по-прежнему не будет пытаться его исправить, поэтому он может оставаться несовместимым до будущих обновлений.
+Если атрибут отдельного элемента или текстовое содержимое неизбежно отличается на сервере и клиенте (например, отметка времени), вы можете отключить предупреждение, добавив к элементу `suppressHydrationWarning={true}`. Он работает только на один уровень в глубину, и задумана как лазейка. Не злоупотребляйте ею. Если это не текстовый контент, React по-прежнему не будет пытаться его исправить, поэтому он может оставаться несовместимым c обновлённым в будущем вариантом.
 
-Если вам преднамеренно нужно отрендерить что-то другое на сервере и клиенте, вы можете выполнить двухпроходный рендеринг. Компоненты, которые рендерят что-то другое на клиенте, могут читать переменную состояния, такую как `this.state.isClient`, которую вы можете установить в `true` в `componentDidMount()`. Таким образом, начальный этап рендеринга будет отображать тот же контент, что и сервер, избегая несовпадений, но дополнительный этап будет происходить синхронно сразу после гидратации. Обратите внимание, что этот подход замедлит ваши компоненты, потому что они должны рендерится дважды, поэтому используйте его с осторожностью.
+Если вам нужно намеренно отрендерить что-то другое на сервере и клиенте, вы можете выполнить двухпроходный рендеринг. Компоненты, которые рендерят что-то другое на клиенте, могут читать переменную состояния, такую как `this.state.isClient`, которую вы можете установить в `true` в `componentDidMount()`. Таким образом, начальный этап рендеринга будет отображать тот же контент, что и сервер, избегая несовпадений, но дополнительный этап будет происходить синхронно сразу после гидратации. Обратите внимание, что этот подход замедлит ваши компоненты, потому что они должны рендерится дважды, поэтому используйте его с осторожностью.
 
 Не забывайте про работу с вашим приложением при медленных соединениях. JavaScript-код может загружаться значительно позже исходного HTML-рендеринга, поэтому, если вы рендерите что-то другое только для клиента, переход может вызвать раздражение. Тем не менее, при правильном выполнении может оказаться полезным отобразить «оболочку» приложения на сервере и показать только некоторые дополнительные виджеты на клиенте. Чтобы узнать, как это сделать без проблем с разметкой, обратитесь к объяснению в предыдущем абзаце.
 
@@ -80,25 +80,26 @@ React ожидает, что отрендеренное содержимое и
 ReactDOM.unmountComponentAtNode(container)
 ```
 
-Удалите смотированный компонент React из DOM и очистите его обработчики событий и состояние. Если в контейнер не было смотировано ни одного компонента, вызов этой функции ничего не делает. Возвращает `true`, если компонент был размонтирован, и `false` если нет компонента для размонтирования.
+Удаляет смотированный компонент React из DOM и очищает его обработчики событий и состояние. Если в контейнер не было смотировано ни одного компонента, вызов этой функции ничего не делает. Возвращает `true`, если компонент был размонтирован, и `false` если нет компонента для размонтирования.
+
 * * *
 
 ### `findDOMNode()` {#finddomnode}
 
 > Примечание:
 >
-> `findDOMNode` — это лазейка, используемая для доступа к базовому узлу DOM. В большинстве случаев использование этого метода не рекомендуется, поскольку он пробивает абстракцию компонента. [Метод устарел в `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
+> `findDOMNode` — это лазейка, используемая для доступа к базовому узлу DOM. В большинстве случаев использование этого метода не рекомендуется, поскольку он нарушает абстракцию компонента. [Метод устарел в `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
 
 ```javascript
 ReactDOM.findDOMNode(component)
 ```
-Если этот компонент был смотирован в DOM, он возвращает соответствующий DOM элемент браузера. Этот метод полезен для чтения значений из DOM, таких как значения полей формы, и произведения измерений DOM. **В большинстве случаев, вы можете присоеденить реф к узлу DOM и совсем избежать использования `findDOMNode`.** 
+Если этот компонент был смотирован в DOM, он возвращает соответствующий DOM элемент браузера. Этот метод полезен для чтения напрямую из DOM (например, чтение значений полей формы) или произведения измерений DOM. **В большинстве случаев, вы можете присоеденить реф к узлу DOM и полностью избежать использования `findDOMNode`.** 
 
 Когда компонент рендерится в `null` или `false`, `findDOMNode` возвращает `null`. Когда компонент рендерится в строку, `findDOMNode` возвращает текстовый узел DOM, содержащий это значение. Начиная с React 16, компонент может возвращать фрагмент с несколькими дочерними элементами, и в этом случае `findDOMNode` возвращает DOM-узел, соответствующий первому непустому дочернему элементу.
 
 > Примечание:
 >
-> `findDOMNode` работает только с смотированными компонентами (то есть компонентами, которые были размещены в DOM). Если вы попытаетесь вызвать этот метод для компонента, который еще не был смонтирован (например, вызовете `findDOMNode()` в методе `render()` для компонента, который еще не был создан), будет сгенерировано исключение.
+> `findDOMNode` работает только с смотированными компонентами (то есть компонентами, которые были размещены в DOM). Если вы попытаетесь вызвать этот метод для компонента, который еще не был смонтирован (например, вызовете `findDOMNode()` в методе `render()` для компонента, который ещё не был создан), будет сгенерировано исключение.
 >
 > `findDOMNode` не может быть использован с функциональными компонентами.