From 1b95ac775bb252def6d4a66ad5c178344f05896a Mon Sep 17 00:00:00 2001
From: Olena Sovyn <olenasovyn@gmail.com>
Date: Tue, 26 Feb 2019 23:39:45 +0000
Subject: [PATCH 1/6] Initial Ukrainian translation to ReactDOM docs chapter

---
 content/docs/reference-react-dom.md | 65 ++++++++++++++---------------
 1 file changed, 32 insertions(+), 33 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 3732ebe8d..9a8a63a75 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}
+## Огляд {#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,41 +18,40 @@ The `react-dom` package provides DOM-specific methods that can be used at the to
 - [`findDOMNode()`](#finddomnode)
 - [`createPortal()`](#createportal)
 
-### Browser Support {#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 та наступні, також [деякі поліфіли необхідні](/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 та es5-sham](https://github.com/es-shims/es5-shim) включені в сторінку. Це тільки ваш вибір, якщо ви вирішити піти цим шляхом.
 
 * * *
 
-## Reference {#reference}
+## Довідка {#reference}
 
 ### `render()` {#render}
 
 ```javascript
 ReactDOM.render(element, container[, callback])
 ```
+Рендерить React елемент в наданий `container` в DOMі і повертає [рефи](/docs/more-about-refs.html) на компонент (або повертає `null` для [компонентів без стану](/docs/components-and-props.html#functional-and-class-components)).
 
-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 елемент був попердньо відрендерений в `container`, цей метод виконає його оновлення і змінить DOM за необхідністю аби відобразити останній варіант React елементу.
 
-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.
+Якщо надано функцію зворотнього виклику, вона буде виконана після того, як компонент відрендериться або оновиться.
 
-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` кращим рішенням буде приєдати [рефо]
+> [рефову функцію зворотнього виклику](/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()` для гідратування серверно-рендерених контейнерів заcтаріле і буде видалено в React 17. Використовуйте [`hydrate()`](#hydrate) натомість.
 
 * * *
 
@@ -62,15 +61,15 @@ If the optional callback is provided, it will be executed after the component is
 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 рендер, тому якщо ви відрендерити щось по-інакшому тільки в клієнтській частині, перехід може бути не злагоджений. Однак, якщо виконано добре, може бути корисно рендерити "оболонку" додатку на сервері, і тльки показувати деякі екстра віджети на клієнті. Для того, щоб навчитись це робити і при цьому не отримати незбіжностей в розмітці, зверніться до пояснень в попередньому параграфі.
 
 * * *
 
@@ -80,28 +79,28 @@ Remember to be mindful of user experience on slow connections. The JavaScript co
 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` якщо компонент було демонтовано та `false` якщо не було ніякого компоненту, який би можна було демонтувати.
 
 * * *
 
 ### `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` не може використовуватись з функціональними компонентами.
 
 * * *
 
@@ -111,4 +110,4 @@ When a component renders to `null` or `false`, `findDOMNode` returns `null`. Whe
 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 ffa08355fd1d19a80e551594724ed773bb835eea Mon Sep 17 00:00:00 2001
From: Olena Sovyn <olenasovyn@gmail.com>
Date: Wed, 27 Feb 2019 10:05:14 +0000
Subject: [PATCH 2/6] Fix typos

---
 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 9a8a63a75..c8f53706f 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>` тегу, ці API високого рівня доступні на глобальній змінній `ReactDOM`. Якщо ви використовуєте ES6 з npm, ви можете написати `import ReactDOM from 'react-dom'`. Якщо ви використовуєте ES5 з npm, ви можете написати `var ReactDOM = require('react-dom')`.
 
 ## Огляд {#overview}
 
@@ -24,7 +24,7 @@ React підтримує всі популярні браузери, включ
 
 > Примітка
 >
-> Ми не підтримуємо старіші браузери, які не підтримують ES5 методів, але ви можете помітити, що ваш додадток працює і в старих бразуерах також якщо поліфіли такі як [es5-shim та es5-sham](https://github.com/es-shims/es5-shim) включені в сторінку. Це тільки ваш вибір, якщо ви вирішити піти цим шляхом.
+> Ми не підтримуємо старіші браузери, які не підтримують ES5 методів, але ви можете помітити, що ваш додаток працює і в старих бразуерах також якщо поліфіли такі як [es5-shim та es5-sham](https://github.com/es-shims/es5-shim) включені в сторінку. Це тільки ваш вибір, якщо ви вирішити піти цим шляхом.
 
 * * *
 
@@ -37,7 +37,7 @@ ReactDOM.render(element, container[, callback])
 ```
 Рендерить React елемент в наданий `container` в DOMі і повертає [рефи](/docs/more-about-refs.html) на компонент (або повертає `null` для [компонентів без стану](/docs/components-and-props.html#functional-and-class-components)).
 
-Якщо React елемент був попердньо відрендерений в `container`, цей метод виконає його оновлення і змінить DOM за необхідністю аби відобразити останній варіант React елементу.
+Якщо React елемент був попередньо відрендерений в `container`, цей метод виконає його оновлення і змінить DOM за необхідністю аби відобразити останній варіант React елементу.
 
 Якщо надано функцію зворотнього виклику, вона буде виконана після того, як компонент відрендериться або оновиться.
 
@@ -45,13 +45,13 @@ ReactDOM.render(element, container[, callback])
 >
 > `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) до коріневого елементу.
+> `ReactDOM.render()` наразі повертає посилання на кореневий екземпляр `ReactComponent`. Однак використання цього значення застаріле і
+> і його потрібно уникати, оскільки майбутні версії React-у можуть рендерити компоненти асинхронно в деяких випадках. Якщо вам потрібно посилання на корінь екземпляра `ReactComponent` кращим рішенням буде приєднати
+> [рефову функцію зворотнього виклику](/docs/more-about-refs.html#the-ref-callback-attribute) до кореневого елементу.
 >
-> Використання `ReactDOM.render()` для гідратування серверно-рендерених контейнерів заcтаріле і буде видалено в React 17. Використовуйте [`hydrate()`](#hydrate) натомість.
+> Використання `ReactDOM.render()` для гідратації серверно-рендерених контейнерів застаріле і буде видалено в React 17. Використовуйте [`hydrate()`](#hydrate) натомість.
 
 * * *
 
@@ -61,15 +61,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 рендер, тому якщо ви відрендерити щось по-інакшому тільки в клієнтській частині, перехід може бути не злагоджений. Однак, якщо виконано добре, може бути корисно рендерити "оболонку" додатку на сервері, і тільки показувати деякі екстра віджети на клієнті. Для того, щоб навчитись це робити і при цьому не отримати незбіжностей в розмітці, зверніться до пояснень в попередньому параграфі.
 
 * * *
 
@@ -79,7 +79,7 @@ React очікує, що відрендерений контент іденти
 ReactDOM.unmountComponentAtNode(container)
 ```
 
-Видаляє змонтований React компонент з DOM-у та очищує обробники подій та стран. Якщо ніякий компонент не було змонтовано в контейнер, виклик цієї функції нічого не робить. Повертає `true` якщо компонент було демонтовано та `false` якщо не було ніякого компоненту, який би можна було демонтувати.
+Видаляє змонтований React компонент з DOM-у та очищує обробники подій та стан. Якщо ніякий компонент не було змонтовано в контейнер, виклик цієї функції нічого не робить. Повертає `true` якщо компонент було демонтовано та `false` якщо не було ніякого компоненту, який би можна було демонтувати.
 
 * * *
 
@@ -92,13 +92,13 @@ ReactDOM.unmountComponentAtNode(container)
 ```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` не може використовуватись з функціональними компонентами.
 

From 12c3f921adb7b79929de8303c6d3fe7e65e27957 Mon Sep 17 00:00:00 2001
From: Olena Sovyn <olenasovyn@gmail.com>
Date: Wed, 27 Feb 2019 14:36:13 +0000
Subject: [PATCH 3/6] minor test improvements and fixes

---
 content/docs/reference-react-dom.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index c8f53706f..8b0d05ef7 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -10,7 +10,7 @@ permalink: docs/react-dom.html
 
 ## Огляд {#overview}
 
-Пакет `react-dom` надає DOM-специфічні методи, що можуть використовуватись на верхньому рівні вашого додатку, а також як запасний спосіб аби вийти з React моделі, якщо це необхідно.В більшості ваших компонентах вам не потрібно використовувати цей модуль.
+Пакет `react-dom` надає DOM-специфічні методи, що можуть використовуватись на верхньому рівні вашого додатку, а також як запасний спосіб аби вийти з React моделі, якщо це необхідно. В більшості ваших компонентів вам не потрібно використовувати цей модуль.
 
 - [`render()`](#render)
 - [`hydrate()`](#hydrate)
@@ -20,7 +20,7 @@ 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.
 
 > Примітка
 >
@@ -35,7 +35,7 @@ React підтримує всі популярні браузери, включ
 ```javascript
 ReactDOM.render(element, container[, callback])
 ```
-Рендерить React елемент в наданий `container` в DOMі і повертає [рефи](/docs/more-about-refs.html) на компонент (або повертає `null` для [компонентів без стану](/docs/components-and-props.html#functional-and-class-components)).
+Рендерить React елемент в наданий `container` в DOM-і і повертає [реф](/docs/more-about-refs.html) на компонент (або повертає `null` для [компонентів без стану](/docs/components-and-props.html#functional-and-class-components)).
 
 Якщо React елемент був попередньо відрендерений в `container`, цей метод виконає його оновлення і змінить DOM за необхідністю аби відобразити останній варіант React елементу.
 
@@ -47,8 +47,8 @@ ReactDOM.render(element, container[, callback])
 >
 > `ReactDOM.render()` не модифікує ноду контенера (тільки модифікує дітей контейнера). Може бути також можливим вставити компонент в наявну DOM ноду без перезапису наявних дітей.
 >
-> `ReactDOM.render()` наразі повертає посилання на кореневий екземпляр `ReactComponent`. Однак використання цього значення застаріле і
-> і його потрібно уникати, оскільки майбутні версії React-у можуть рендерити компоненти асинхронно в деяких випадках. Якщо вам потрібно посилання на корінь екземпляра `ReactComponent` кращим рішенням буде приєднати
+> `ReactDOM.render()` наразі повертає посилання на кореневий екземпляр `ReactComponent`. Однак використання цього значення, яке повертається, застаріле і
+> і його потрібно уникати, оскільки майбутні версії React-у можуть рендерити компоненти асинхронно в деяких випадках. Якщо вам потрібне посилання на корінь екземпляра `ReactComponent` кращим рішенням буде приєднати
 > [рефову функцію зворотнього виклику](/docs/more-about-refs.html#the-ref-callback-attribute) до кореневого елементу.
 >
 > Використання `ReactDOM.render()` для гідратації серверно-рендерених контейнерів застаріле і буде видалено в React 17. Використовуйте [`hydrate()`](#hydrate) натомість.
@@ -61,15 +61,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 все ж не буде намагатись пропатчити його, тому він може залишитись різним до наступних оновлень.
 
-Якщо вам потрібно спеціально відрендерити щось по різному на сервері та на клієнті, ви можете зробити двох-прохідний рендеринг. Компоненти, що рендерять щось по-інакшому на клієнті можуть читати певну змінну на стані (для прикладу, `this.state.isClient`), якій ви можете присвоїти `true` в `componentDidMount()`. Таким чином початковий прохід рендеру відрендерить той же контент, що і на сервері, таким чином уникнувши незбіжностей, але додатковий прохід відбудеться синхронно одразу після гідрування. Зауважте, що такий підхід зробить компоненти повільнішими оскільки вони будуть рендеритись двічі, тому використовуйте такий підхід обережно.
+Якщо вам потрібно спеціально відрендерити щось по-різному на сервері та на клієнті, ви можете зробити двох-прохідний рендеринг. Компоненти, що рендерять щось по-іншому на клієнті можуть читати певну змінну на стані (для прикладу, `this.state.isClient`), якій ви можете присвоїти `true` в `componentDidMount()`. Початковий прохід рендеру відрендерить той же контент, що і на сервері, таким чином уникнувши незбіжностей, а додатковий прохід відбудеться синхронно одразу після гідратації. Зауважте, що такий підхід зробить компоненти повільнішими, оскільки вони будуть рендеритись двічі, тому використовуйте такий підхід обережно.
 
-Пам'ятайте зважати на досвід користувача в при повільному з'єднанні. JavaScript код може завантажуватись набагато пізніше, ніж початковий HTML рендер, тому якщо ви відрендерити щось по-інакшому тільки в клієнтській частині, перехід може бути не злагоджений. Однак, якщо виконано добре, може бути корисно рендерити "оболонку" додатку на сервері, і тільки показувати деякі екстра віджети на клієнті. Для того, щоб навчитись це робити і при цьому не отримати незбіжностей в розмітці, зверніться до пояснень в попередньому параграфі.
+Пам'ятайте зважати на досвід користувача при повільному з'єднанні. JavaScript код може завантажуватись набагато пізніше, ніж початковий HTML рендер, тому якщо ви рендерити щось по-іншому тільки в клієнтській частині, перехід може бути не злагоджений. Однак, якщо виконано добре, може бути корисно рендерити "оболонку" додатку на сервері, і тільки показувати деякі екстра віджети на клієнті. Для того, щоб навчитись це робити і при цьому не отримати незбіжностей в розмітці, зверніться до пояснень в попередньому параграфі.
 
 * * *
 
@@ -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 6131318ffa7190dae50000da12bd0316731e55c2 Mon Sep 17 00:00:00 2001
From: Olena Sovyn <olenasovyn@gmail.com>
Date: Wed, 27 Feb 2019 21:45:52 +0000
Subject: [PATCH 4/6] Improve translation

---
 content/docs/reference-react-dom.md | 47 +++++++++++++++--------------
 1 file changed, 24 insertions(+), 23 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 8b0d05ef7..9d21f64e4 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 -- `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 та наступні, також [деякі поліфіли необхідні](/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) включені в сторінку. Це тільки ваш вибір, якщо ви вирішити піти цим шляхом.
 
 * * *
 
@@ -35,23 +35,24 @@ React підтримує всі популярні браузери, в тому
 ```javascript
 ReactDOM.render(element, container[, callback])
 ```
-Рендерить React елемент в наданий `container` в DOM-і і повертає [реф](/docs/more-about-refs.html) на компонент (або повертає `null` для [компонентів без стану](/docs/components-and-props.html#functional-and-class-components)).
 
-Якщо React елемент був попередньо відрендерений в `container`, цей метод виконає його оновлення і змінить DOM за необхідністю аби відобразити останній варіант React елементу.
+Рендерить React-елемент у наданий `container` в DOM-і і повертає [реф](/docs/more-about-refs.html) на компонент (або повертає `null` для [компонентів без стану](/docs/components-and-props.html#functional-and-class-components)).
+
+Якщо React-елемент був попередньо відрендерений в `container`, цей метод виконає його оновлення і змінить DOM за необхідністю, щоб відобразити останній варіант React-елемента.
 
 Якщо надано функцію зворотнього виклику, вона буде виконана після того, як компонент відрендериться або оновиться.
 
 > Примітка:
 >
-> `ReactDOM.render()` контролює контент ноди контейнера, яку ви передаєте. Будь-який наявний DOM елемент всередині буде замінено під час першого виклику. Наступні виклики використовують React-овий алгоритм різниці 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) до кореневого елементу.
+> `ReactDOM.render()` наразі повертає посилання на кореневий екземпляр `ReactComponent`. Однак, використання значення, що повертається є застарілим
+> і його потрібно уникати, оскільки майбутні версії React можуть рендерити компоненти асинхронно в деяких випадках. Якщо вам потрібне посилання на корінь екземпляра `ReactComponent` кращим рішенням буде приєднати
+> [реф зворотнього виклику](/docs/more-about-refs.html#the-ref-callback-attribute) до кореневого елементу.
 >
-> Використання `ReactDOM.render()` для гідратації серверно-рендерених контейнерів застаріле і буде видалено в React 17. Використовуйте [`hydrate()`](#hydrate) натомість.
+> Використання `ReactDOM.render()` для гідратації відрендерених сервером контейнерів застаріле і буде видалено в React 17. Натомість використовуйте [`hydrate()`](#hydrate).
 
 * * *
 
@@ -61,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()`. Початковий прохід рендеру відрендерить той же контент, що і на сервері, таким чином уникнувши незбіжностей, а додатковий прохід відбудеться синхронно одразу після гідратації. Зауважте, що такий підхід зробить компоненти повільнішими, оскільки вони будуть рендеритись двічі, тому використовуйте такий підхід обережно.
+Якщо вам потрібно відрендерити щось, що відрізняється на сервері та клієнті, ви можете зробити двохпрохідний рендеринг. Компоненти, в яких є відмінності в рендерингу на клієнті, можуть читати змінну стану, наприклад, `this.state.isClient`, якій ви можете присвоїти `true` в `componentDidMount()`. Початковий прохід рендеру відрендерить той же вміст, що і на сервері, таким чином уникнувши незбіжностей, а додатковий прохід відбудеться синхронно одразу після гідратації. Зауважте, що такий спосіб зробить компоненти повільнішими, оскільки вони будуть рендеритись двічі, тому використовуйте його обережно.
 
-Пам'ятайте зважати на досвід користувача при повільному з'єднанні. JavaScript код може завантажуватись набагато пізніше, ніж початковий HTML рендер, тому якщо ви рендерити щось по-іншому тільки в клієнтській частині, перехід може бути не злагоджений. Однак, якщо виконано добре, може бути корисно рендерити "оболонку" додатку на сервері, і тільки показувати деякі екстра віджети на клієнті. Для того, щоб навчитись це робити і при цьому не отримати незбіжностей в розмітці, зверніться до пояснень в попередньому параграфі.
+Пам’ятайте про те, що користувачу має бути комфортно працювати при повільному з'єднанні. JavaScript-код може завантажуватись набагато пізніше, ніж початковий HTML-рендер, тому якщо ви рендерите щось, що відрізняється тільки на стороні клієнта, перехід може бути не злагоджений. Однак, якщо спосіб двохрохідного рендерингу використано вдало, то рендеринг "оболонки" додатку на сервері, і показ деяких віджетів лише на клієнті матиме свої переваги. Для того, щоб навчитись це робити і при цьому не отримати незбіжностей в розмітці, зверніться до пояснень в попередньому параграфі.
 
 * * *
 
@@ -79,7 +80,7 @@ React очікує, що відрендерений контент іденти
 ReactDOM.unmountComponentAtNode(container)
 ```
 
-Видаляє змонтований React компонент з DOM-у та очищує обробники подій та стан. Якщо ніякий компонент не було змонтовано в контейнер, виклик цієї функції нічого не робить. Повертає `true` якщо компонент було демонтовано та `false` якщо не було ніякого компоненту, який би можна було демонтувати.
+Видаляє змонтований React-компонент з DOM-у та очищує обробників подій та стан. Якщо ніякий компонент не було змонтовано в контейнер, виклик цієї функції нічого не робить. Повертає `true`, якщо компонент було демонтовано та `false` якщо не було ніякого компоненту, який би можна було демонтувати.
 
 * * *
 
@@ -87,18 +88,18 @@ 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. **У більшості випадках, ви можете приєднати ref до 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 +111,4 @@ ReactDOM.findDOMNode(component)
 ReactDOM.createPortal(child, container)
 ```
 
-Створює портал. Портали надають можливість [рендерити дітей в DOM ноду, яка існує за межами ієрархії DOM компоненту](/docs/portals.html).
+Створює портал. Портали надають можливість [рендерити дочірні елементи у DOM-вузол, який існує за межами ієрархії DOM-компонента](/docs/portals.html).

From 72dd88faf874c52c0a42b5e8d8c9a736509f9144 Mon Sep 17 00:00:00 2001
From: Olena Sovyn <olenasovyn@gmail.com>
Date: Sat, 9 Mar 2019 16:32:20 +0000
Subject: [PATCH 5/6] Improve translation

---
 content/docs/reference-react-dom.md | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 9d21f64e4..5f24ad7c6 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -36,19 +36,19 @@ React підтримує всі популярні браузери, в тому
 ReactDOM.render(element, container[, callback])
 ```
 
-Рендерить React-елемент у наданий `container` в DOM-і і повертає [реф](/docs/more-about-refs.html) на компонент (або повертає `null` для [компонентів без стану](/docs/components-and-props.html#functional-and-class-components)).
+Рендерить React-елемент у наданий `container` у DOM-і і повертає [реф](/docs/more-about-refs.html) на компонент (або повертає `null` для [компонентів без стану](/docs/components-and-props.html#functional-and-class-components)).
 
-Якщо React-елемент був попередньо відрендерений в `container`, цей метод виконає його оновлення і змінить DOM за необхідністю, щоб відобразити останній варіант React-елемента.
+Якщо React-елемент був попередньо відрендерений у `container`, цей метод виконає його оновлення і змінить DOM за необхідністю, щоб відобразити останній варіант React-елемента.
 
 Якщо надано функцію зворотнього виклику, вона буде виконана після того, як компонент відрендериться або оновиться.
 
 > Примітка:
 >
-> `ReactDOM.render()` контролює вміст вузла контейнера, яку ви передаєте. Будь-який наявний DOM-елемент всередині буде замінено під час першого виклику. Наступні виклики використовують React-овий алгоритм різниці DOM-ів для ефективних оновлень.
+> `ReactDOM.render()` контролює вміст вузла контейнера, який ви передаєте. Будь-який наявний DOM-елемент всередині буде замінено під час першого виклику. Наступні виклики використовують React-овий алгоритм різниці DOM-ів для ефективних оновлень.
 >
 > `ReactDOM.render()` не модифікує вузол контейнера (тільки модифікує нащадків). Також можливо вставити компонент у наявний DOM-вузол без перезапису наявних нащадків.
 >
-> `ReactDOM.render()` наразі повертає посилання на кореневий екземпляр `ReactComponent`. Однак, використання значення, що повертається є застарілим
+> `ReactDOM.render()` наразі повертає посилання на кореневий екземпляр `ReactComponent`. Однак використання значення, що повертається, є застарілим
 > і його потрібно уникати, оскільки майбутні версії React можуть рендерити компоненти асинхронно в деяких випадках. Якщо вам потрібне посилання на корінь екземпляра `ReactComponent` кращим рішенням буде приєднати
 > [реф зворотнього виклику](/docs/more-about-refs.html#the-ref-callback-attribute) до кореневого елементу.
 >
@@ -64,13 +64,13 @@ ReactDOM.hydrate(element, container[, callback])
 
 Такий же як [`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()`. Початковий прохід рендеру відрендерить той же вміст, що і на сервері, таким чином уникнувши незбіжностей, а додатковий прохід відбудеться синхронно одразу після гідратації. Зауважте, що такий спосіб зробить компоненти повільнішими, оскільки вони будуть рендеритись двічі, тому використовуйте його обережно.
+Якщо вам потрібно відрендерити щось, що відрізняється на сервері та клієнті, ви можете зробити двопрохідний рендеринг. Компоненти, в яких є відмінності в рендерингу на клієнті, можуть читати змінну стану, наприклад, `this.state.isClient`, якій ви можете присвоїти `true` в `componentDidMount()`. Початковий прохід рендеру відрендерить той же вміст, що і на сервері, таким чином уникнувши незбіжностей, а додатковий прохід відбудеться синхронно відразу після гідратації. Зауважте, що такий спосіб зробить компоненти повільнішими, оскільки вони будуть рендеритись двічі, тому використовуйте його обережно.
 
-Пам’ятайте про те, що користувачу має бути комфортно працювати при повільному з'єднанні. JavaScript-код може завантажуватись набагато пізніше, ніж початковий HTML-рендер, тому якщо ви рендерите щось, що відрізняється тільки на стороні клієнта, перехід може бути не злагоджений. Однак, якщо спосіб двохрохідного рендерингу використано вдало, то рендеринг "оболонки" додатку на сервері, і показ деяких віджетів лише на клієнті матиме свої переваги. Для того, щоб навчитись це робити і при цьому не отримати незбіжностей в розмітці, зверніться до пояснень в попередньому параграфі.
+Пам’ятайте про те, що користувачу має бути комфортно працювати при повільному з'єднанні. JavaScript-код може завантажитись набагато пізніше, ніж початковий HTML-рендер, тому якщо ви рендерите щось, що відрізняється тільки на стороні клієнта, перехід може бути незлагодженим. Однак, якщо спосіб двопрохідного рендерингу використано вдало, то рендеринг "оболонки" додатку на сервері і показ деяких віджетів лише на клієнті матиме свої переваги. Для того, щоб навчитись це робити і при цьому не отримати незбіжностей у розмітці, зверніться до пояснень у попередньому параграфі.
 
 * * *
 
@@ -80,7 +80,7 @@ React очікує, що відрендерений вміст ідентичн
 ReactDOM.unmountComponentAtNode(container)
 ```
 
-Видаляє змонтований React-компонент з DOM-у та очищує обробників подій та стан. Якщо ніякий компонент не було змонтовано в контейнер, виклик цієї функції нічого не робить. Повертає `true`, якщо компонент було демонтовано та `false` якщо не було ніякого компоненту, який би можна було демонтувати.
+Видаляє змонтований React-компонент з DOM-у та очищує обробників подій та стан. Якщо ніякий компонент не було змонтовано в контейнер, виклик цієї функції нічого не робить. Повертає `true`, якщо компонент було демонтовано та `false`, якщо не було ніякого компоненту, який би можна було демонтувати.
 
 * * *
 
@@ -88,12 +88,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. **У більшості випадках, ви можете приєднати ref до DOM-вузла і уникнути використання `findDOMNode` взагалі.**
+Якщо цей компонент був змонтований у DOM, цей метод поверне відповідний нативний браузерний DOM-елемент. Цей метод корисний для читання значення з DOM-у, таких як значення полів форми та вимірювань DOM. **У більшості випадків, ви можете приєднати ref до DOM-вузла і уникнути використання `findDOMNode` взагалі.**
 
 Якщо компонент рендериться в `null` або `false`, `findDOMNode` повертає `null`. Коли компонент рендериться в рядок, `findDOMNode` повертає текстовий DOM-вузол, який містить значення. Починаючи з React 16, компонент може повертати фрагмент з декількома дочірніми елементами, в цьому випадку `findDOMNode` поверне DOM-вузол, що відповідає першому не порожньому нащадку.
 

From 6fc4b79e36bec31d7239c0311418d15a140cc1b1 Mon Sep 17 00:00:00 2001
From: Olena Sovyn <olenasovyn@gmail.com>
Date: Sun, 10 Mar 2019 21:34:57 +0000
Subject: [PATCH 6/6] Improve translation

---
 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 5f24ad7c6..b6a0b38c1 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -88,7 +88,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)