Создаём ветку для задачи

Зачем нужна отдельная ветка для задачи

Принцип: Для каждой задачи создается своя ветка

Причины:

1. Безопасность: Main остается стабильным, баги не попадают в production
2. Код-ревью: Pull Request создается из рабочей ветки в main
3. Параллельная работа: Можно начать новую задачу, пока предыдущая на ревью
4. Откат изменений: Легко удалить ветку, main не пострадает

Правило: Всегда создавать ветки от main

Алгоритм:

1. Убедиться, что вы в main (индикатор в правом нижнем углу)
2. Создать ветку от main
3. Переключиться в новую ветку (Checkout)
4. Начать работу

Способы создания ветки

Способ 1: Верхнее меню

• Git → New Branch
• Создает от текущей активной ветки

Способ 2: Индикатор ветки

• Клик на main (правый нижний угол) → New Branch

Способ 3: Панель Git (рекомендуется)

• Вкладка Git → ПКМ на main → New Branch from 'main'
• Явно видно от какой ветки создаем

Правила именования веток

Структура:

PREFIX-НОМЕР_УРОКА-НОМЕР_ЗАДАЧИ-краткое-описание

Пример:

KS-1-1-sum-calculation
PROJ-5-2-add-login-button

Компоненты:

1. Префикс (PREFIX):

   • Сокращение названия проекта
   • KotlinSprint → KS
   • В реальных проектах: код задачи из Jira (PROJ-123)

2. Номер урока и задачи:

   • Урок 1, задача 1 → 1-1
   • Урок 5, задача 3 → 5-3
   • В реальных проектах: номер задачи

3. Краткое описание:

   • 2-4 слова через дефис
   • На английском языке
   • Что делается в задаче
   • Примеры: sum-calculation, add-button, fix-crash

Требования:

• Все маленькими буквами (lowercase)
• Слова через дефисы -
• БЕЗ пробелов
• БЕЗ кириллицы
• БЕЗ специальных символов (кроме дефиса)

Процесс создания ветки

1. Правый клик на main в панели Git → New Branch from 'main'
2. Окно Create New Branch:
   • Name: вводим название (например, KS-1-1-sum-calculation)
   • Checkout branch: оставить галочку (переключиться в ветку)
3. Нажать Create

Результат создания

Визуальные изменения:

1. Индикатор ветки (правый нижний угол):

   • Изменился с main на KS-1-1-sum-calculation
   • Показывает текущую активную ветку

2. Панель Git → Local Branches:

   • Две ветки: main и KS-1-1-sum-calculation
   • Значок ярлычка у активной ветки

3. График коммитов:

   • Initial Commit теперь имеет 3 метки:
     • [main]
     • [origin/main]
     • [KS-1-1-sum-calculation]
   • Все ветки указывают на один коммит

Что произошло технически

1. Git сделал "снимок" текущего состояния main
2. Создал новую ветку с этим снимком
3. Переключил в новую ветку (если галочка Checkout)

Изоляция:

• Изменения в KS-1-1 НЕ влияют на main
• Изменения в KS-1-1 НЕ влияют на другие ветки
• Безопасное пространство для разработки

Частая ошибка: Создание ветки от рабочей ветки

Неправильно:

1. Вы в ветке KS-1-1
2. Создаете ветку KS-1-2 прямо от KS-1-1

Проблема:

• KS-1-2 содержит всё из KS-1-1
• Если в 1-1 найдут ошибки, они будут и в 1-2
• Конфликты при слиянии

Правильно:

1. Переключиться в main
2. Создать KS-1-2 от main
3. Начать работу

Исключение: Можно создавать от рабочей ветки, если точно понимаете зачем и умеете разрешать конфликты

Переключение между ветками

1. Клик на индикатор ветки (правый нижний угол)
2. Выбрать нужную ветку из списка
3. Нажать Checkout (Переключиться)

Или:

• Панель Git → ПКМ на ветке → Checkout

Checkout — переключение в другую ветку

Что происходит:

• Файлы в проекте изменяются на версию из выбранной ветки
• Индикатор ветки обновляется
• Вы работаете теперь в другой ветке

Состояние проекта после создания ветки

• Структура файлов такая же, как в main
• Это нормально! Ветка — точная копия main
• Как только изменим/создадим файл — ветки начнут различаться