09 — Ветки и пул-реквесты

Ветка — это безопасная копия проекта, где можно работать, не трогая main. Пул-реквест — это просьба вернуть проделанную работу обратно.

Когда нужна ветка

• Изменение достаточно большое, чтобы недоделанная работа что-то сломала.
• Кто-то должен посмотреть на него до выхода «в прод».
• Вы хотите попробовать идею и иметь возможность её выбросить.

Ради опечатки в документе можно спокойно коммитить прямо в main.

Создание ветки в браузере

При коммите (глава 03) выберите Создать новую ветку для этого коммита и открыть пул-реквест, задайте имя ветки и закоммитьте. Хорошие имена описывают работу:

docs/vlan-notes
fix/wrong-gateway
feature/report-export

Открытие пул-реквеста

1. Перейдите в Пул-реквесты → Новый пул-реквест.
2. Выберите исходную ветку (вашу) и целевую (main).
3. Заголовок = что делает изменение. Описание = зачем, плюс всё, что стоит проверить рецензентам.
4. Нажмите Создать пул-реквест.

Ревью

• Рецензенты комментируют отдельные строки на вкладке Изменённые файлы.
• Отправляйте новые коммиты в ту же ветку — пул-реквест обновится сам.
• После одобрения нажмите Слить пул-реквест, затем удалите ветку.

Конфликты слияния

Если в main изменили те же строки, что и вы, KabaForge попросит разрешить конфликт. Со своего компьютера:

git switch my-branch
git fetch origin
git merge origin/main
# откройте помеченные файлы, оставьте правильные строки
git add .
git commit
git push

Защита main

Настройки → Ветки → Добавить правило: требовать пул-реквест и одобрения до того, как что-либо попадёт в main. Рекомендуется, как только в репозитории работает больше одного человека.