reactjs · vldmrkl · Mar 30, 2019 · Mar 27, 2019 · Mar 27, 2019 · Mar 28, 2019
diff --git a/README.md b/README.md
@@ -1,70 +1,70 @@
-# reactjs.org
+# uk.reactjs.org
 
-This repo contains the source code and documentation powering [reactjs.org](https://reactjs.org/).
+Цей репозиторій містить вихідний код та документацію для сайту [uk.reactjs.org](https://uk.reactjs.org/).
 
-## Getting started
+## Початок
 
-### Prerequisites
+### Передумови
 
 1. Git
-1. Node: any 8.x version starting with 8.4.0 or greater
-1. Yarn: See [Yarn website for installation instructions](https://yarnpkg.com/lang/en/docs/install/)
-1. A fork of the repo (for any contributions)
-1. A clone of the [reactjs.org repo](https://github.com/reactjs/reactjs.org) on your local machine
+1. Node: будь-яка версія 8.x, починаючи з 8.4.0 або вище
+1. Yarn: Див. [сайт Yarn з інструкціями по встановленню](https://yarnpkg.com/uk/docs/install)
+1. Зробити форк цього репозиторію (для пропозицій змін)
+1. Клонувати [uk.reactjs.org repo](https://github.com/reactjs/uk.reactjs.org) на ваш комп'ютер
 
-### Installation
+### Встановлення
 
-1. `cd reactjs.org` to go into the project root
-1. `yarn` to install the website's npm dependencies
+1. `cd uk.reactjs.org` для переходу в кореневу директорію проекту
+1. `yarn` для встановлення npm-залежностей проекту
 
-### Running locally
+### Запуск проекта локально
 
-1. `yarn dev` to start the hot-reloading development server (powered by [Gatsby](https://www.gatsbyjs.org))
-1. `open http://localhost:8000` to open the site in your favorite browser
+1. `yarn dev` для запуску сервера розробки з підтримкою гарячого перезавантаження (на основі [Gatsby](https://www.gatsbyjs.org))
+1. `open http://localhost:8000` щоб відкрити сайт в браузері за замовчуванням
 
-## Contributing
+## Участь у проекті
 
-### Guidelines
+### Рекомендації
 
-The documentation is divided into several sections with a different tone and purpose. If you plan to write more than a few sentences, you might find it helpful to get familiar with the [contributing guidelines](https://github.com/reactjs/reactjs.org/blob/master/CONTRIBUTING.md#guidelines-for-text) for the appropriate sections.
+Ця документація поділена на декілька частин з різними стилями та цілями. Якщо ви плануєте написати більше, ніж декілька речень, вам може бути корисно ознайомитись з [допоміжними вказівками (англ.)](https://github.com/reactjs/uk.reactjs.org/blob/master/CONTRIBUTING.md#guidelines-for-text) для відповідних розділів.
 
-### Create a branch
+### Створення гілки
 
-1. `git checkout master` from any folder in your local `reactjs.org` repository
-1. `git pull origin master` to ensure you have the latest main code
-1. `git checkout -b the-name-of-my-branch` (replacing `the-name-of-my-branch` with a suitable name) to create a branch
+1. `git checkout master` в будь-якій директорії вашої локальної копії проекту `uk.reactjs.org`
+1. `git pull origin master`, щоб пересвідчитись що у вас остання версія коду
+1. `git checkout -b the-name-of-my-branch` (замініть `the-name-of-my-branch` на підходяще ім'я) для створення гілки
 
-### Make the change
+### Внесення змін
 
-1. Follow the "Running locally" instructions
-1. Save the files and check in the browser
-  1. Changes to React components in `src` will hot-reload
-  1. Changes to markdown files in `content` will hot-reload
-  1. If working with plugins, you may need to remove the `.cache` directory and restart the server
+1. Дотримуйтесь інструкцій з розділу "Запуск проекта локально"
+1. Збережіть файли і перевірте зміни в браузері
+  1. Зміни до React-компонентів всередині `src` застосовуються відразу
+  1. Зміни до файлів markdown всередині `content` застосовуються відразу
+  1. При роботі з плагінами можливо знадобиться видалити директорію `.cache` та перезавантажити сервер
 
-### Test the change
+### Перевірка змін
 
-1. If possible, test any visual changes in all latest versions of common browsers, on both desktop and mobile.
-1. Run `yarn check-all` from the project root. (This will run Prettier, ESLint, and Flow.)
+1. Якщо можливо, перевіряйте всі візуальні зміни в усіх останніх версіях розповсюджених браузерів: настільних та мобільних.
+1. Виконайте `yarn check-all` з кореневої директорії проекту. (Це виконає Prettier, ESLint та Flow.)
 
-### Push it
+### Публікація змін
 
-1. `git add -A && git commit -m "My message"` (replacing `My message` with a commit message, such as `Fixed header logo on Android`) to stage and commit your changes
+1. `git add -A && git commit -m "My message"` (замініть `My message` на назву коміту, наприклад `Fixed header logo on Android`), для збереження ваших змін
 1. `git push my-fork-name the-name-of-my-branch`
-1. Go to the [reactjs.org repo](https://github.com/reactjs/reactjs.org) and you should see recently pushed branches.
-1. Follow GitHub's instructions.
-1. If possible, include screenshots of visual changes. A Netlify build will also be automatically created once you make your PR so other people can see your change.
+1. Перейдіть на [сторінку репозиторію uk.reactjs.org](https://github.com/reactjs/uk.reactjs.org) і ви повинні побачити нещодавно оновлені гілки.
+1. Дотримуйтесь інструкцій на GitHub.
+1. По можливості додайте знімок екрану ваших візуальних змін. Netlify створить сторінку для попереднього перегляду автоматично після створення PR для того, щоб інші люди могли бачити ваші зміни.
 
-## Translation
+## Переклад
 
-If you are interested in translating `reactjs.org`, please see the current translation efforts at [isreacttranslatedyet.com](https://www.isreacttranslatedyet.com/).
+Якщо ви зацікавлені у перекладі `reactjs.org`, будь-ласка ознайомтесь з поточним прогресом перекладу на сторінці [isreacttranslatedyet.com](https://www.isreacttranslatedyet.com/).
 
 
-If your language does not have a translation and you would like to create one, please follow the instructions at [reactjs.org Translations](https://github.com/reactjs/reactjs.org-translation#translating-reactjsorg).
+Якщо переклад на вашу мову наразі не існує і ви б хотіли його створити, то дотримуйтесь інструкцій [Перекладу reactjs.org](https://github.com/reactjs/reactjs.org-translation#translating-reactjsorg).
 
-## Troubleshooting
+## Вирішення проблем
 
-- `yarn reset` to clear the local cache
+- `yarn reset` для очищення локального кешу
 
-## License
-Content submitted to [reactjs.org](https://reactjs.org/) is CC-BY-4.0 licensed, as found in the [LICENSE-DOCS.md](https://github.com/open-source-explorer/reactjs.org/blob/master/LICENSE-DOCS.md) file.
+## Ліцензія
+Контент, наданий на [uk.reactjs.org](https://uk.reactjs.org/), надається по ліцензії CC-BY-4.0, як описано в файлі [LICENSE-DOCS.md](https://github.com/open-source-explorer/reactjs.org/blob/master/LICENSE-DOCS.md).