Create branch-management.asc

Author: Morganov

book/03-git-branching/sections/branch-management.asc

@@ -93,8 +93,8 @@ $ git branch --no-merged master
 $ git branch --move bad-branch-name corrected-branch-name
 ----
 
-Это заменяет `bad-branch-name` на `corrected-branch-name`, но это изменение пока только локальное.
-Чтобы другие увидели исправленную ветку в другом репозитории, отправьте её туда:
+Ветка `bad-branch-name` будет переименована в `corrected-branch-name`, но это изменение пока только локальное.
+Чтобы все остальные увидели исправленную ветку в удалённом репозитории, отправьте её туда:
 
 [source,console]
 ----
@@ -113,10 +113,8 @@ $ git branch --all
   remotes/origin/main
 ----
 
-Обратите внимание, что мы на ветке `corrected-branch-name`.
-Исправленная ветка есть в другом репозитории.
-Однако неправильная ветка по-прежнему еще присутствует там.
-Вы можете удалить лишнюю ветку:
+Обратите внимание, что текущая ветка `corrected-branch-name`, которая также присутствует и на удалённом сервере.
+Однако, старая ветка всё ещё по-прежнему там, но её можно удалить с помощью команды:
 
 [source,console]
 ----
@@ -131,27 +129,27 @@ $ git push origin --delete bad-branch-name
 ====
 Изменение имени ветки, например master/main/mainline/default, сломает интеграции, службы, вспомогательные утилиты и скрипты сборки, которые использует ваш репозиторий.
 Прежде чем сделать это, обязательно проконсультируйтесь с коллегами.
-Также убедитесь, что вы выполнили тщательный поиск в своем репо и обновили все ссылки на старое имя ветки в вашем коде или скриптах.
+Также убедитесь, что вы выполнили тщательный поиск в своём репозитории и обновили все ссылки на старое имя ветки в вашем коде или скриптах.
 ====
 
-Переименуйте локальную ветку `master` в `main` с помощью следующей команды
+Переименуйте локальную ветку `master` в `main` с помощью следующей команды:
 
 [source,console]
 ----
 $ git branch --move master main
 ----
 
-Локальной ветки `master` больше нет, потому что она переименована в ветку `main`.
+После этого, локальной ветки `master` больше не существует, потому что она была переименована в ветку `main`.
 
-Чтобы другие могли видеть новую ветку `main`, вам нужно отправить её в общий репозиторий.
-Это делает переименованную ветку доступной остальным.
+Чтобы все остальные могли видеть новую ветку `main`, вам нужно отправить её в общий репозиторий.
+Это делает переименованную ветку доступной в удалённом репозитории.
 
 [source,console]
 ----
 $ git push --set-upstream origin main
 ----
 
-Теперь мы получаем следующее состояние:
+В итоге, состояние репозитория становится следующим:
 
 [source,console]
 ----
@@ -163,20 +161,20 @@ git branch --all
 ----
 
 Ваша локальная ветка `master` исчезла, так как она заменена веткой `main`.
-Ветка `main` также доступна в общем репозитории.
-Но там всё ещё есть ветка `master`.
-Другие участники будут продолжать использовать ветку `master` в качестве основы для своей работы, пока вы не внесете в неё некоторые изменения.
+Ветка `main` доступна в удалённом репозитории.
+Старая ветка `master` всё ещё присутствует в удалённом репозитории.
+Остальные участники будут продолжать использовать ветку `master` в качестве основы для своей работы, пока вы не совершите ряд дополнительных действий.
 
-Теперь у вас есть еще несколько задач для завершения перехода:
+Теперь, для завершения перехода на новую ветку перед вами стоят следующие задачи:
 
-* Любые проекты, которые зависят от этого, должны будут обновить свой код и/или конфигурацию.
-* Обновите все файлы конфигурации средства запуска тестов.
-* Настройте скрипты сборки и публикации.
-* Поправьте настройки для таких вещей, как ветка по умолчанию, правила слияния и другие вещи, которые зависят от имён веток.
-* Обновите ссылки на старую ветку в документации.
-* Закройте или слейте любые запросы на принятие изменений, нацеленные на старую ветку.
+* Все проекты, которые зависят от текущего, должны будут обновить свой код и/или конфигурацию.
+* Обновите конфигурацию всех запускаемых тестов.
+* Исправьте скрипты сборки и публикации артефактов.
+* Поправьте настройки репозитория на сервере: задайте новую ветку по умолчанию, обновите правила слияния, а также прочие настройки, которые зависят от имени веток.
+* Обновите документацию, исправив ссылки, указывающие на старую ветку.
+* Слейте или отмените запросы на слияние изменений, нацеленные на старую ветку.
 
-После того, как вы выполнили все эти задачи и уверены, что основная ветка работает так же, как ветка `master`, вы можете удалить ветку `master`:
+После того, как вы выполнили все эти задачи и уверены, что ветка `main` работает так же, как ветка `master`, вы можете удалить ветку `master`:
 
 [source, console]
 ----