From aa311f940bcb52111d2091767f188e14ed878d84 Mon Sep 17 00:00:00 2001 From: Sergey Date: Thu, 20 Jul 2017 18:47:33 +0700 Subject: [PATCH] Update README.ru.md --- translations/README.ru.md | 53 ++++++++++++++++++++++++++++----------- 1 file changed, 38 insertions(+), 15 deletions(-) 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 состоит из сотрудничества и совместной работы. Мы хотим облегчить первые шаги в обучении и сотрудничестве начинающим разработчикам. + +Чтение статей и учебников может помочь, но что может быть лучше, чем настоящий практический опыт, без риска что-либо испортить. Этот проект нацелен предоставить руководство и упростить путь новобранцам сделать их первый вклад. Помните: чем меньше вы напряжены, тем лучше вы учитесь. Если вы ищете возможность осуществить свой первый вклад, просто следуйте простым шагам, расположенным ниже. Обещаем, будет интересно. + fork this repository -*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 this repository -Теперь склонируйте ваш репозиторий на пк. Нажмите на кнопку "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`. Нажмите на нее. create a pull request @@ -84,27 +89,45 @@ git push origin submit pull request +Скоро я произведу объединение всех ваших изменений с основной ветвью данного проекта. Вы получите сообщение по электронной почте, когда изменения будут приняты (смержены). + +Основная ветвь вашего репозитория не будет изменена. Для синхронизации выполните шаги, расположенные ниже. + ## Синхронизируйте ваше ответвление с данным репозиторием -Теперь вы готовы смержить все ваши изменения в мастер-ветку данного репозитория. Данные изменения не будут добавлены к вашему ответвлению. Для того, чтобы синхронизировать ваше ответлвение с моим, добавьте ссылку на мой репозиторий с помощью `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 +``` +Это совершенно не обязательно, но название этой ветви отражает ее довольно специфическое назначение. И продолжительность ее жизни может быть соответствующе короткой. + ## Использование других инструментов |GitHub Desktop|Visual Studio 2017|GitKraken| @@ -114,7 +137,7 @@ git push origin master ## Что далее? -Ниже несколько популярных репозиториев, где вы можете найти задания для ноичков. Вперед, перейдите в репозитории, чтобы узнать больше. +Ниже несколько популярных репозиториев, где вы можете найти задания для новичков. Вперед, перейдите в репозитории, чтобы узнать больше. |[![exercism](https://avatars2.githubusercontent.com/u/5624255?v=3&s=100)](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[![fun-retro](https://avatars3.githubusercontent.com/u/15913975?v=3&s=100)](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)|[![habitat](https://avatars1.githubusercontent.com/u/18171698?v=3&s=100)](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![scikit-learn](https://avatars0.githubusercontent.com/u/365630?v=3&s=100)](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)|[![elasticsearch](https://avatars2.githubusercontent.com/u/6764390?v=3&s=100)](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| |---|---|---|---|---|---|---|---|