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

srgizh · srgizh · commit 36b0b61ebda7 · 2021-02-20T17:54:47.000-08:00
diff --git a/book/03-git-branching/sections/basic-branching-and-merging.asc b/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(+)
 ----
 
diff --git a/book/03-git-branching/sections/branch-management.asc b/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,112 @@ $ 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` в качестве основы для своей работы, пока вы не внесете в неё некоторые изменения.
+
+Теперь у вас есть еще несколько задач для завершения перехода:
+
+* Любые проекты, которые зависят от этого, должны будут обновить свой код и/или конфигурацию.
+* Обновите все файлы конфигурации средства запуска тестов.
+* Настройте скрипты сборки и публикации.
+* Поправьте настройки для таких вещей, как ветка по умолчанию, правила слияния и другие вещи, которые зависят от имён веток.
+* Обновите ссылки на старую ветку в документации.
+* Закройте или слейте любые запросы на принятие изменений, нацеленные на старую ветку.
+
+После того, как вы выполнили все эти задачи и уверены, что основная ветка работает так же, как ветка `master`, вы можете удалить ветку `master`:
+
+[source, console]
+----
+$ git push origin --delete master
+----
diff --git a/book/03-git-branching/sections/nutshell.asc b/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 -`.
+====
