Merge pull request #371 from SergeiKuznetsov/ch3-sync

Синхронизация с оригиналом (глава 3)

Author: Morganov

book/03-git-branching/sections/basic-branching-and-merging.asc

@@ -50,7 +50,7 @@ image::images/basic-branching-2.png["Создание нового указат
 [source,console]
 ----
 $ vim index.html
-$ git commit -a -m 'added a new footer [issue 53]'
+$ git commit -a -m 'Create new footer [issue 53]'
 ----
 
 .Ветка iss53 двигается вперед 
@@ -133,8 +133,8 @@ Deleted branch hotfix (3a0874c).
 $ git checkout iss53
 Switched to branch "iss53"
 $ vim index.html
-$ git commit -a -m 'finished the new footer [issue 53]'
-[iss53 ad82d7a] finished the new footer [issue 53]
+$ git commit -a -m 'Finish the new footer [issue 53]'
+[iss53 ad82d7a] Finish the new footer [issue 53]
 1 file changed, 1 insertion(+)
 ----
 

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

@@ -22,9 +22,9 @@ $ git branch
 [source,console]
 ----
 $ git branch -v
-  iss53   93b412c fix javascript issue
+  iss53   93b412c Fix javascript issue
 * master  7a98805 Merge branch 'iss53'
-  testing 782fd34 add scott to the author list in the readmes
+  testing 782fd34 Add scott to the author list in the readme
 ----
 
 Опции `--merged` и `--no-merged` могут отфильтровать этот список для вывода только тех веток, которые слиты или ещё не слиты в текущую ветку.
@@ -73,3 +73,110 @@ $ git branch --no-merged master
   featureB
 ----
 ====
+
+==== Переименование ветки
+
+[CAUTION]
+====
+Не переименовывайте ветки, которые всё ещё используются другими участниками.
+Не переименовывайте ветку в master/main/mainline, не прочитав раздел «Изменение имени главной ветки».
+====
+
+Предположим, у вас есть ветка с именем `bad-branch-name`, и вы хотите изменить её на `corrected-branch-name`, сохранив при этом всю историю.
+Вместе с этим, вы также хотите изменить имя ветки на удалённом сервере (GitHub, GitLab или другой сервер).
+Как это сделать?
+
+Переименуйте ветку локально с помощью команды `git branch --move`:
+
+[source, console]
+----
+$ git branch --move bad-branch-name corrected-branch-name
+----
+
+Ветка `bad-branch-name` будет переименована в `corrected-branch-name`, но это изменение пока только локальное.
+Чтобы все остальные увидели исправленную ветку в удалённом репозитории, отправьте её туда:
+
+[source,console]
+----
+$ git push --set-upstream origin corrected-branch-name
+----
+
+Теперь проверим, где мы сейчас находимся:
+
+[source, console]
+----
+$ git branch --all
+* corrected-branch-name
+  main
+  remotes/origin/bad-branch-name
+  remotes/origin/corrected-branch-name
+  remotes/origin/main
+----
+
+Обратите внимание, что текущая ветка `corrected-branch-name`, которая также присутствует и на удалённом сервере.
+Однако, старая ветка всё ещё по-прежнему там, но её можно удалить с помощью команды:
+
+[source,console]
+----
+$ git push origin --delete bad-branch-name
+----
+
+Теперь старое имя ветки полностью заменено исправленным.
+
+===== Изменение имени главной ветки
+
+[WARNING]
+====
+Изменение имени ветки, например master/main/mainline/default, сломает интеграции, службы, вспомогательные утилиты и скрипты сборки, которые использует ваш репозиторий.
+Прежде чем сделать это, обязательно проконсультируйтесь с коллегами.
+Также убедитесь, что вы выполнили тщательный поиск в своём репозитории и обновили все ссылки на старое имя ветки в вашем коде или скриптах.
+====
+
+Переименуйте локальную ветку `master` в `main` с помощью следующей команды:
+
+[source,console]
+----
+$ git branch --move master main
+----
+
+После этого, локальной ветки `master` больше не существует, потому что она была переименована в ветку `main`.
+
+Чтобы все остальные могли видеть новую ветку `main`, вам нужно отправить её в общий репозиторий.
+Это делает переименованную ветку доступной в удалённом репозитории.
+
+[source,console]
+----
+$ git push --set-upstream origin main
+----
+
+В итоге, состояние репозитория становится следующим:
+
+[source,console]
+----
+git branch --all
+* main
+  remotes/origin/HEAD -> origin/master
+  remotes/origin/main
+  remotes/origin/master
+----
+
+Ваша локальная ветка `master` исчезла, так как она заменена веткой `main`.
+Ветка `main` доступна в удалённом репозитории.
+Старая ветка `master` всё ещё присутствует в удалённом репозитории.
+Остальные участники будут продолжать использовать ветку `master` в качестве основы для своей работы, пока вы не совершите ряд дополнительных действий.
+
+Теперь, для завершения перехода на новую ветку перед вами стоят следующие задачи:
+
+* Все проекты, которые зависят от текущего, должны будут обновить свой код и/или конфигурацию.
+* Обновите конфигурацию всех запускаемых тестов.
+* Исправьте скрипты сборки и публикации артефактов.
+* Поправьте настройки репозитория на сервере: задайте новую ветку по умолчанию, обновите правила слияния, а также прочие настройки, которые зависят от имени веток.
+* Обновите документацию, исправив ссылки, указывающие на старую ветку.
+* Слейте или отмените запросы на слияние изменений, нацеленные на старую ветку.
+
+После того, как вы выполнили все эти задачи и уверены, что ветка `main` работает так же, как ветка `master`, вы можете удалить ветку `master`:
+
+[source, console]
+----
+$ git push origin --delete master
+----

book/03-git-branching/sections/nutshell.asc

@@ -14,7 +14,7 @@
 [source,console]
 ----
 $ git add README test.rb LICENSE
-$ git commit -m 'initial commit of my project'
+$ git commit -m 'Initial commit'
 ----
 
 Когда вы создаёте коммит командой `git commit`, Git вычисляет контрольные суммы каждого подкаталога (в нашем случае, только основной каталог проекта) и сохраняет его в репозитории как объект дерева каталогов.
@@ -81,9 +81,9 @@ image::images/head-to-master.png["HEAD указывает на ветку"]
 [source,console]
 ----
 $ git log --oneline --decorate
-f30ab (HEAD, master, testing) add feature #32 - ability to add new
-34ac2 fixed bug #1328 - stack overflow under certain conditions
-98ca9 initial commit of my project
+f30ab (HEAD -> master, testing) Add feature #32 - ability to add new formats to the central interface
+34ac2 Fix bug #1328 - stack overflow under certain conditions
+98ca9 Initial commit
 ----
 
 Здесь можно увидеть указывающие на коммит `f30ab` ветки: `master` и `testing`.
@@ -175,11 +175,11 @@ image::images/advance-master.png["Разветвлённая история"]
 [source,console]
 ----
 $ git log --oneline --decorate --graph --all
-* c2b9e (HEAD, master) made other changes
-| * 87ab2 (testing) made a change
+* c2b9e (HEAD, master) Made other changes
+| * 87ab2 (testing) Made a change
 |/
-* f30ab add feature #32 - ability to add new formats to the
-* 34ac2 fixed bug #1328 - stack overflow under certain conditions
+* f30ab Add feature #32 - ability to add new formats to the central interface
+* 34ac2 Fix bug #1328 - stack overflow under certain conditions
 * 98ca9 initial commit of my project
 ----
 
@@ -199,3 +199,12 @@ $ git log --oneline --decorate --graph --all
 Как правило, при создании новой ветки вы хотите сразу на неё переключиться -- это можно сделать используя команду `git checkout -b <newbranchname>`.
 ====
 
+[NOTE]
+====
+Начиная с Git версии 2.23, вы можете использовать `git switch` вместо `git checkout`, чтобы:
+
+- Переключиться на существующую ветку: `git switch testing-branch`.
+- Создать новую ветку и переключиться на нее: `git switch -c new-branch`.
+Флаг `-c` означает создание, но также можно использовать полный формат:` --create`.
+- Вернуться к предыдущей извлечённой ветке: `git switch -`.
+====