Рабочие процессы с ответвлениями на GitHub

Представьте, что вы хотите внести вклад в проект с открытым исходным кодом, но у вас нет разрешения напрямую изменять его код. Здесь на помощь приходит создание ответвления!

Ответвление — это личная копия чужого репозитория GitHub. Она находится в вашей собственной учётной записи GitHub, поэтому вы можете свободно экспериментировать и вносить изменения, не затрагивая исходный проект.

Основная причина создать ответвление репозитория — предложить изменения в проект, когда у вас нет прямого доступа на запись в его исходную кодовую базу.

• Безопасные эксперименты: работайте со своей копией, не опасаясь повредить исходный проект.
• Путь к участию: это стандартный способ предлагать функции или исправления для общедоступных проектов.
• Личные проекты: используйте ответвление как отправную точку для собственного связанного проекта.

Создать ответвление репозитория на GitHub очень просто:

1. Перейдите к исходному репозиторию, который хотите ответвить.
2. Найдите кнопку «Fork», обычно расположенную в правом верхнем углу.
3. Нажмите кнопку «Fork». GitHub создаст копию этого репозитория в вашей учётной записи.

Теперь у вас будет github.com/YOUR_USERNAME/ORIGINAL_REPO_NAME.

После создания ответвления репозитория на GitHub вам нужно загрузить эту копию на свой локальный компьютер, чтобы начать работу с ней.

Используйте команду git clone, но обязательно клонируйте URL своего ответвления, а не URL исходного репозитория.

Теперь, когда ваше ответвление клонировано локально, вы можете вносить изменения, как и в любом другом проекте Git. Рекомендуется создать новую ветку для функции или исправления.

После локальной фиксации изменений отправьте их в своё удалённое ответвление на GitHub. Это обновит вашу личную копию репозитория.

Удалённый репозиторий origin обычно указывает на ваше ответвление.

Пока вы работаете со своим ответвлением, в исходном репозитории (который часто называют «upstream») могут появляться новые обновления. Чтобы ваше ответвление оставалось актуальным, его нужно синхронизировать.

Сначала добавьте исходный репозиторий как новый удалённый репозиторий с именем upstream. Затем получите и объедините его изменения.

Когда изменения завершены и отправлены в ваше ответвление, вы готовы предложить их исходному проекту. Это делается с помощью запроса на включение изменений (PR).

На GitHub перейдите в своё ответвление. Часто вы увидите баннер с предложением создать PR из новой ветки. Следуйте инструкциям, чтобы сравнить свою ветку с основной веткой исходного репозитория и отправить предложение.

Кратко типичный рабочий процесс с ответвлением выглядит так:

• Создание ответвления: создайте личную копию на GitHub.
• Клонирование: загрузите своё ответвление на локальный компьютер.
• Разработка: внесите изменения в новой ветке.
• Отправка: отправьте изменения в своё удалённое ответвление.
• Синхронизация: поддерживайте ответвление в актуальном состоянии относительно исходного проекта.
• Запрос на включение изменений: предложите свои изменения исходному проекту.

На этом уроке вы изучили рабочий процесс создания ответвлений на GitHub. Теперь вы понимаете, что ответвление создаёт личную копию репозитория и позволяет участвовать в проектах даже без прямого доступа на запись.

Мы рассмотрели создание ответвления, клонирование, внесение изменений, отправку изменений в своё ответвление, синхронизацию с исходным репозиторием и, наконец, создание запроса на включение изменений для предложения своего вклада. Этот рабочий процесс — основа совместной разработки на GitHub!