diff --git a/translations/README.ru.md b/translations/README.ru.md
index 5679b4d0b41..58a2f4320ee 100644
--- a/translations/README.ru.md
+++ b/translations/README.ru.md
@@ -3,21 +3,25 @@
# Первый вклад в проект
+Сложно. Всегда сложно начинать что-то с самого начала. Довольно неудобно совершать ошибки, особенно если вы работаете в команде. Весь open source состоит из сотрудничества и совместной работы. Мы хотим облегчить первые шаги в обучении и сотрудничестве начинающим разработчикам.
+
+Чтение статей и учебников может помочь, но что может быть лучше, чем настоящий практический опыт, без риска что-либо испортить. Этот проект нацелен предоставить руководство и упростить путь новобранцам сделать их первый вклад. Помните: чем меньше вы напряжены, тем лучше вы учитесь. Если вы ищете возможность осуществить свой первый вклад, просто следуйте простым шагам, расположенным ниже. Обещаем, будет интересно.
+
-*Read this in other languages: [English](README.md), [Spanish](README.es.md), [Dutch](README.nl.md), [Hindi](README.hi.md) [Japanese](README.ja.md), [Greek](README.gr.md)*
+*Read this in other languages: [English](../README.md), [Indonesian](README.id.md), [Spanish](README.es.md), [Dutch](README.nl.md), [Hindi](README.hi.md), [Japanese](README.ja.md), [Vietnamese](README.vn.md), [Polish](README.pl.md), [Korean](README.ko.md), [German](README.de.md), [Simplified Chinese](README.chs.md), [Traditional Chinese](README.cht.md), [Greek](README.gr.md), [العربية](README.ar.md), [Ukrainian](README.ua.md).*
Если у вас не установлен git на компьютере, [ установите его ]( https://help.github.com/articles/set-up-git/ )
## Создайте ответвление
-Создайте собственное ответвление, нажав на кнопку "fork"
+Создайте собственное ответвление, нажав на кнопку `fork` сверху этой страницы. Таким образом вы создадите копию этого репозитория в своем аккаунте.
## Склонируйте репозиторий
-Теперь склонируйте ваш репозиторий на пк. Нажмите на кнопку "clone", а затем на иконку планшета, чтобы скопировать ссылку.
+Теперь склонируйте ваш репозиторий на пк. Нажмите на кнопку `clone`, а затем на иконку `copy to clipboard`, чтобы скопировать ссылку.
Откройте терминал и запустите следующую git команду:
@@ -32,16 +36,16 @@ git clone "url you just copied"
```
git clone https://github.com/this-is-you/first-contributions.git
```
-Где 'this-is-you' ваш логин на github'e. Таким образом вы копируете репозиторий для вашего первого вклада на ваш компьютер.
+Где `this-is-you` ваш логин на github'e. Таким образом вы копируете репозиторий 'first-contributions' с GitHub на ваш пк.
-## Создайте ветку
+## Создайте ветвь
-Перейдите в директорию репозитория на вашем компьютере, если вы еще не там.
+Перейдите в каталог репозитория на вашем компьютере, если вы еще не там.
```
cd first-contributions
```
-Теперь создайте ветку, с помощью `команды git checkout`
+Теперь создайте ветвь, с помощью `команды git checkout`
```
git checkout -b
@@ -51,10 +55,11 @@ git checkout -b
```
git checkout -b add-alonzo-church
```
+(Синтаксически не требуется чтобы название ветви содержало слово *add*, но это оправдано, поскольку подчеркивает назначение этой ветви - добавить ваше имя в список.)
## Внесите необходимые изменения и создайте коммит
-Откройте файл `Contributors.md` в вашем текстовом редакторе, впешите ваше имя и сохраните файл. Если вы перейдете в директорию проекта и выполните `git status`, вы увидите изменения. Добавьте эти изменения с помощью команды `git add`.
+Теперь откройте файл `Contributors.md` в вашем текстовом редакторе, впешите ваше имя и сохраните файл. Если вы перейдете в директорию проекта и выполните `git status`, вы увидите изменения. Добавьте эти изменения с помощью команды `git add`.
```
git add Contributors.md
@@ -72,11 +77,11 @@ git commit -m "Add to Contributors list"
```
git push origin
```
-Измените `` на имя ветки, которую вы создали ранее.
+Измените `` на имя ветви, которую вы создали ранее.
## Подтвердите измнения для ревью
-Если вы зайдете в свой репозиторий на github, вы увидите кнопку `Compare & pull request`. Нажмите на нее.
+Если вы зайдете в свой репозиторий на GitHub, вы увидите кнопку `Compare & pull request`. Нажмите на нее.
@@ -84,27 +89,45 @@ git push origin
+Скоро я произведу объединение всех ваших изменений с основной ветвью данного проекта. Вы получите сообщение по электронной почте, когда изменения будут приняты (смержены).
+
+Основная ветвь вашего репозитория не будет изменена. Для синхронизации выполните шаги, расположенные ниже.
+
## Синхронизируйте ваше ответвление с данным репозиторием
-Теперь вы готовы смержить все ваши изменения в мастер-ветку данного репозитория. Данные изменения не будут добавлены к вашему ответвлению. Для того, чтобы синхронизировать ваше ответлвение с моим, добавьте ссылку на мой репозиторий с помощью `upstream remote url`.
+Прежде всего перейдите в основную ветвь:
+ ```
+ git checkout master
+ ```
+Затем добавьте url моего репозитория в поле `upstream remote url`:
```
-git remote add upstream https://github.com/multunus/first-contributions
+git remote add upstream https://github.com/Roshanjossey/first-contributions
```
Таким образом мы сообщим git'у что существует другая версия данного проекта по определенной ссылке и мы ее считаем мастером. Как только измнения смержены, подгрузите новую версию моего репозитория.
```
git fetch upstream
```
-Таким образом мы забрали все изменения в моем ответвлении (upstream remote). После, вам нужно смержить новую версию моего репозитория с вашей мастер-веткой.
+Таким образом мы забрали все изменения в моем ответвлении (upstream remote). После, вам нужно смержить новую версию моего репозитория с вашей мастер-ветвью.
```
git rebase upstream/master
```
-Так вы применяете все изменения, которые вы подтянули к вашей мастер-ветке. Если вы запушите сейчас мастер-ветку, ваше ответвление тоже будет содержать изменения.
+Так вы применяете все изменения, которые вы подтянули к вашей мастер-ветви. Если вы запушите сейчас мастер-ветвь, ваше ответвление тоже будет содержать изменения.
```
git push origin master
```
Обратите внимение, что вы пушите в удаленной репозиторий origin.
+На этом этапе я объединил вашу ветвь `` со своей мастер-ветвью, а вы объединили свою мастер-ветвь с моей. Ваше ветвь больше нужна, вы можете удалить ее:
+```
+git branch -d
+```
+А так-же можете удалить ее версию в удаленном репозитории:
+```
+git push origin --delete
+```
+Это совершенно не обязательно, но название этой ветви отражает ее довольно специфическое назначение. И продолжительность ее жизни может быть соответствующе короткой.
+
## Использование других инструментов
|
|
|
|
@@ -114,7 +137,7 @@ git push origin master
## Что далее?
-Ниже несколько популярных репозиториев, где вы можете найти задания для ноичков. Вперед, перейдите в репозитории, чтобы узнать больше.
+Ниже несколько популярных репозиториев, где вы можете найти задания для новичков. Вперед, перейдите в репозитории, чтобы узнать больше.
|[](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[
](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[
](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[
](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)|
|---|---|---|---|---|---|---|---|