$ sudo teach IT

До этого момента мы рассматривали работу с собственными репозиториями или проектами, в которых у вас есть прямой доступ на запись. Такой сценарий характерен для большинства коммерческих команд: разработчик получает доступ к репозиторию компании и работает внутри него через ветки и Pull Request.

Однако существует ещё один важный сценарий. Представьте, что вы нашли полезную библиотеку на GitHub. В процессе работы вы обнаружили ошибку или решили добавить новую функциональность. Возникает вопрос: как внести изменения в проект, если вы не являетесь его владельцем и не имеете права записывать изменения напрямую?

Именно для таких ситуаций в GitHub существует механизм Fork. Fork позволяет создать собственную копию чужого репозитория, работать с ней независимо от оригинального проекта и при необходимости предлагать свои изменения владельцам исходного репозитория.

Такой подход лежит в основе Open Source-разработки. Многие популярные проекты, которыми ежедневно пользуются миллионы разработчиков, развиваются именно благодаря вкладу сообщества через Fork и Pull Request. В этом уроке мы разберём, что такое Fork, как он работает и каким образом можно участвовать в развитии чужих проектов.

Ключевые термины

  • Open Source — программное обеспечение с открытым исходным кодом, доступным для изучения и развития другими разработчиками.
  • Fork — независимая копия чужого репозитория в вашем аккаунте GitHub.
  • Contribution — вклад в развитие проекта.
  • Maintainer — человек или команда, поддерживающая проект.
  • Contributor — участник, который предлагает изменения в проект.
  • Upstream — оригинальный репозиторий, из которого был создан Fork.
  • Pull Request — запрос на включение изменений в репозиторий.
  • Issue — задача, ошибка или предложение по улучшению проекта.

Что такое Open Source

Когда начинающие разработчики слышат термин Open Source, они часто воспринимают его как нечто абстрактное. На практике всё довольно просто. Open Source означает, что исходный код проекта открыт для просмотра и изучения.

Любой человек может:

  • скачать проект;
  • посмотреть код;
  • изучить архитектуру;
  • найти ошибку;
  • предложить улучшение.

Большая часть современных технологий развивается именно таким образом.

Например, открытыми являются многие популярные инструменты:

  • Linux;
  • Python;
  • PostgreSQL;
  • Docker;
  • React;
  • Vue;
  • Pandas.

Это не означает, что любой желающий может менять основной репозиторий по своему усмотрению. У проекта всегда есть владельцы и сопровождающие.

Однако сообщество может участвовать в развитии проекта через специальный процесс, который мы сейчас рассмотрим.

Почему нельзя просто сделать Push

Представим, что вы нашли ошибку в популярной библиотеке.

Логичным кажется следующий сценарий:

  • исправить ошибку;
  • выполнить commit;
  • сделать push.

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

Это важный механизм безопасности. Без него любой пользователь интернета мог бы изменять чужие проекты. Поэтому для участия в Open Source используется другая схема. Сначала создаётся Fork.

Что такое Fork

Fork представляет собой копию чужого репозитория внутри вашего аккаунта GitHub. Проще всего представить Fork как команду: «Создать мой собственный экземпляр этого проекта».

После создания Fork в вашем профиле появляется полноценная копия репозитория. Например, существует оригинальный проект github.com/company/electronics-library. После создания Fork может появиться репозиторий github.com/yourname/electronics-library.

Внешне они выглядят почти одинаково. Однако есть важное отличие. Первый репозиторий принадлежит компании. Второй принадлежит вам.

Теперь вы можете:

  • создавать ветки;
  • делать коммиты;
  • выполнять push;
  • экспериментировать с кодом.

При этом оригинальный проект остаётся неизменным.

Fork и Clone — не одно и то же

Очень часто новички путают Fork и Clone. Это разные операции.

Команда git clone создаёт локальную копию репозитория на вашем компьютере. Fork создаёт копию репозитория внутри GitHub.

Можно сказать так:

  • Fork работает на стороне GitHub;
  • Clone работает на стороне вашего компьютера.

На практике они часто используются вместе. Сначала создаётся Fork. Затем выполняется clone уже собственного Fork-репозитория.

Когда используется Fork

В коммерческой разработке Fork применяется не очень часто. Обычно сотрудникам сразу выдают доступ к основному репозиторию. Зато в Open Source Fork является стандартным способом работы.

Типичные ситуации:

  • исправление ошибок;
  • улучшение документации;
  • добавление новой функциональности;
  • перевод проекта на другой язык;
  • улучшение тестов;
  • исправление опечаток.

Даже небольшое исправление документации обычно проходит через Fork и Pull Request.

Типичный процесс работы через Fork

Процесс выглядит следующим образом. Сначала разработчик создаёт Fork.

После этого клонирует его git clone git@github.com:yourname/project.git.

Затем создаёт отдельную ветку git switch -c fix-login-validation

Вносит изменения.

Создаёт коммит:

git add .
git commit -m "Исправлена проверка логина"

Отправляет изменения git push origin fix-login-validation.

После этого на GitHub создаётся Pull Request. Но теперь он направляется не в ваш Fork. Он направляется в оригинальный репозиторий.

Дальше владельцы проекта проверяют изменения и принимают решение:

  • принять изменения;
  • запросить доработки;
  • отклонить Pull Request.

Именно таким образом развивается большинство крупных Open Source-проектов.

Что такое вклад в проект

Вклад в проект не обязательно означает написание большого количества кода. Очень часто полезными оказываются более простые изменения.

Например:

  • исправление опечаток;
  • улучшение README;
  • обновление документации;
  • добавление примеров;
  • написание тестов;
  • исправление небольших ошибок.

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

Наиболее частые ошибки

  • Путать Fork и Clone.
    Fork создаёт копию репозитория на GitHub, а Clone скачивает репозиторий на компьютер.

  • Работать напрямую в основной ветке Fork.
    Для каждой задачи лучше создавать отдельную ветку.

  • Отправлять Pull Request без описания.
    Maintainer должен понимать, что именно изменилось и зачем.

  • Вносить слишком много изменений в одном Pull Request.
    Небольшие изменения проверять значительно проще.

  • Игнорировать правила проекта.
    Многие репозитории содержат инструкции для участников.

  • Не читать README и CONTRIBUTING.
    В этих файлах обычно описаны требования к оформлению изменений.

  • Начинать с очень сложных задач.
    Для первого опыта лучше выбирать небольшие и понятные изменения.

Наиболее частые вопросы

  • Обязательно ли участвовать в Open Source?
    Нет. Однако это хороший способ получить практический опыт и показать свои навыки работодателям.

  • Можно ли делать Fork любого публичного репозитория?
    Да. Именно для этого GitHub предоставляет механизм Fork.

  • Можно ли исправлять только документацию?
    Да. Многие проекты охотно принимают такие изменения.

  • Зачем создавать Fork, если можно сделать Clone?
    Clone не даёт права отправлять изменения на GitHub. Fork создаёт собственную копию репозитория, которой вы управляете.

  • Можно ли использовать Fork в коммерческой разработке?
    Да, но значительно реже. Обычно сотрудники работают через общий корпоративный репозиторий.

  • Стоит ли указывать участие в Open Source в резюме?
    Да. Особенно если вы активно участвовали в развитии известных проектов.

Итоги

В этом уроке вы познакомились с концепцией Open Source и механизмом Fork.

Мы разобрали, зачем нужен Fork, чем он отличается от обычного клонирования репозитория и каким образом разработчики вносят изменения в чужие проекты.

Также вы узнали, как выглядит типичный процесс участия в Open Source: от создания Fork до отправки Pull Request владельцам проекта.

Теперь вы понимаете, каким образом тысячи разработчиков по всему миру совместно развивают популярные библиотеки, фреймворки и инструменты. Эти знания помогут не только работать с открытыми проектами, но и лучше понимать современные процессы разработки программного обеспечения.

На следующий урок