diff --git a/src/ru/general-development/setup/git-for-the-ss14-developer.md b/src/ru/general-development/setup/git-for-the-ss14-developer.md index 4b209046a..eebf40a9c 100644 --- a/src/ru/general-development/setup/git-for-the-ss14-developer.md +++ b/src/ru/general-development/setup/git-for-the-ss14-developer.md @@ -44,7 +44,7 @@ Теперь, когда у вас установлен Git, я рекомендую вам сначала немного почитать о его основах и познакомиться с любым git-клиентом, с которым вы работаете, будь то командная строка (Git Bash) или что-то другое. -Мы рассмотрим процесс создания окружения в Git для Space Station 14, чтобы вы могли **внести свой код через pull request, создать собственную кодовую базу** или просто **посмотреть историю проекта**. +Мы рассмотрим процесс создания окружения Git для Space Station 14, чтобы вы могли **внести свой вклад в проект через Pull Request, создать собственную кодовую базу** или просто **посмотреть историю развития проекта**. ### 1.1 Почему мы вообще используем Git? @@ -64,7 +64,7 @@ GitHub - это онлайн-сервис, на котором размещаю Ваш удаленный репозиторий не будет автоматически синхронизироваться с изменениями из оригинального репозитория SS14 - вам придется делать это самостоятельно, а как это делать я расскажу чуть позже. -Перейдите в [репозиторий Space Station 14](https://github.com/space-wizards/space-station-14) и нажмите на кнопочку которая помечена на скриншоте: +Перейдите в [репозиторий Space Station 14](https://github.com/space-wizards/space-station-14) и нажмите на кнопку «Fork», которая помечена на скриншоте: ![](https://i.imgur.com/lAHNHdD.png) Там вас спросят, где сделать форк и как его назвать - просто зайдите в свой обычный аккаунт и назовите его как угодно! Я бы выбрал `space-station-14`, если вы просто хотите помочь в разработке. @@ -135,7 +135,7 @@ GitHub - это онлайн-сервис, на котором размещаю Затем переключитесь на папку вашего репозитория, используя: ``cd space-station-14`` -(Это может отличаться, если вы клонировали другой форк, но почти всегда это имя совпадает с именем репозитория) +(Название папки может отличаться, если вы клонировали другой репозиторий, но оно почти всегда совпадает с именем репозитория) Каждая команда в Git выглядит примерно так - `git` и затем ключевое слово `add`, `commit`, `pull` и т.д. @@ -148,7 +148,7 @@ GitHub - это онлайн-сервис, на котором размещаю ### 2.3 Боль с сабмодулями -**Обратите на это внимание!** Если вы не сделаете этого, то при попытке создать игру вы получите множество странных ошибок. +**Обратите на это внимание!** Если вы не сделаете этого, то при попытке скомпилировать игру вы получите множество странных ошибок. В Space Station 14 есть *множество* субмодулей - в первую очередь, наш движок RobustToolbox. Субмодули - это просто репозитории внутри репозитория, и их нужно обновлять вручную. Или нет? @@ -201,7 +201,7 @@ GitHub - это онлайн-сервис, на котором размещаю Все, что это делает, - добавляет новый удаленый репозиторий с именем `upstream`, который указывает на исходный репозиторий `space-wizards/space-station-14`. Теперь мы можем получать обновления из основного репозитория, когда захотим! (о том, как это сделать, читайте ниже). -Принято называть удалённый репозиторий, указывающее на исходный репозиторий, `upstream`, но технически вы можете называть его как угодно. Однако я буду ссылаться на него как на «upstream», и это терминология, которую также используют руководства Git. +Принято называть удалённый репозиторий, указывающий на исходный репозиторий, как `upstream`, но технически вы можете называть его как угодно. Однако я буду ссылаться на него как на «upstream», и это терминология, которую также используют руководства Git. **Дополнение для разработчиков форков:** Если репозиторий, в который вы хотите внести вклад, настроен как прямой форк (IE: GitHub показывает метку «forked from» под именем репозитория), то вам дополнительно нужно добавить этот форк в качестве удаленного (но если форк не настроен таким образом, вы можете проигнорировать это). Вы можете сделать это аналогично тому, как вы добавили upstream в качестве remote (просто используйте ссылку на GitHub форка в качестве URL remote), но не забудьте заменить имя remote `upstream` на любое имя, которое вы считаете подходящим. Для этого ваш собственный форк не обязательно должен быть форком форка; важно лишь, чтобы история коммитов в отдельных ветках, которые вы отправляете на свой собственный удалённый ресурс, совпадала с историей коммитов того, куда вы собираетесь добавлять свои изменения. @@ -228,9 +228,9 @@ GitHub - это онлайн-сервис, на котором размещаю ### 4.2 Что такое это ваша ветка(бранч)? -**Ветки**(в русском сообществе их называют бранчи!) очень, очень важны. По сути, это просто список изменений в коде (коммитов). По умолчанию используется бранч 'master', и все наши серверы используют эту ветку для компиляции кода. +**Ветки** очень, очень важны. По сути, это просто список изменений в коде (коммитов). По умолчанию используется ветка 'master', и все наши серверы используют эту ветку для компиляции кода. -Вы практически всегда находитесь "в бранче", когда работаете с кодом, и вы можете легко переключать ветку, в которой работаете. +Вы практически всегда находитесь "в ветке", когда работаете с кодом, и вы можете легко переключать ветку, в которой работаете. Как правило, ветки называются по имени того, над чем вы собираетесь в них работать, но на самом деле не имеет значения, как они называются. Вы можете создавать столько веток, сколько захотите. Когда вы создаете ветку, она «отходит» (нифига себе, правда?) от текущей ветки, на которой вы находитесь, и становится полностью независимой, в которую вы можете добавлять коммиты. @@ -241,7 +241,7 @@ GitHub - это онлайн-сервис, на котором размещаю #### Объединение веток -Ветви важны, потому что они могут быть **мерджнуты** вместе. Именно так функции интегрируются в основную ветку `master`. **Слияние** означает «взять специальные коммиты из этой ветки и применить их к другой ветке». Вы можете объединить две любые ветки. +Ветви важны, потому что они могут быть **слиты** вместе. Процесс слияния также называется мердж (от англ. merge). Именно так функции интегрируются в основную ветку `master`. **Слияние** означает «взять коммиты с новыми изменениями кода из этой ветки и применить их к другой ветке с другой версией кода». Вы можете объединить две любые ветки. Иногда это не проходит гладко, потому что обе ветки изменяют одну и ту же часть файла противоречивыми способами, и в этом случае вы получите **мердж конфликт** - подробнее об этом в дополнениях. @@ -297,7 +297,7 @@ Pull Requests(в русском сообществе их обычно назы Теперь вы можете свободно работать с этой веткой по своему усмотрению, не боясь испортить важную мастер-ветку. -Переключаться между ветками довольно просто: когда вы это делаете, ваши локальные файлы и папки будут изменены в соответствии с веткой, поэтому Git будет кричать на вас(и я тоже), если у вас есть локальные изменения, а вы пытаетесь сменить ветку. +Переключаться между ветками довольно просто: когда вы это делаете, ваши локальные файлы и папки будут изменены в соответствии с веткой, поэтому Git будет кричать на вас, если у вас есть локальные изменения, а вы пытаетесь сменить ветку. Меняем ветку: @@ -327,7 +327,7 @@ Pull Requests(в русском сообществе их обычно назы
-Затем внесите любые локальные изменения! Это не имеет значения. Создайте новый файл, удалите всё, измените одну строку в файле и т. д. Это не повлияет на вашу `мастерскую` ветку, потому что теперь это земля `funny-feature`! +Затем внесите любые локальные изменения! Это не имеет значения. Создайте новый файл, удалите всё, измените одну строку в файле и т. д. Это не повлияет на вашу `master` ветку, потому что теперь вы находитесь на ветке `funny-feature`! ### 4.4 Staging and committing changes to your branch