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

Я предполагаю, что у вас будет учетная запись GitHub и минимальные знания о продвижении, извлечении коммитов и т. Д. Итак, следующее, что вам нужно сделать, это найти хороший проект, чтобы внести свой вклад. Убедитесь, что он обслуживается, чтобы кто-то одобрил ваши изменения. Итак, приступим прямо сейчас.

Шаг 1. Создайте вилку

Форк - это просто ваша копия исходного проекта. Перейдите на страницу репозитория, и вы найдете опцию в правом верхнем углу.

Это создаст вилку исходного репо под вашим профилем. После его создания вы будете автоматически перенаправлены. Я выбрал для демонстрации проект под названием react-lazy-hydration (кстати, это крутой проект, на который стоит обратить внимание, если вы разработчик React).

Шаг 2: клонируйте вилку

Теперь вам нужно настроить рабочую копию в своей системе. Клонируйте только что созданный форк.

Используйте команду git clone.

git clone <fork-repo-url>

Например,

git clone https://github.com/arcteezy/react-lazy-hydration.git

Шаг 3. Внесите изменения

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

git checkout -b <new-branch-name>

Например

git checkout -b update-readme

Это создаст новую ветку, и вы автоматически переключитесь на нее. Теперь творите свое волшебство! Внесите свой вклад в базу кода.

Шаг 4. Публикация изменений

Когда вы закончите, пришло время внести изменения. Вы будете публиковать свои изменения не непосредственно в исходном репозитории, а в первую очередь в своей вилке. Вы спросите, почему именно так? Потому что у вас нет доступа для записи в исходный репозиторий.

git push -u origin <new-branch-name>

Например,

git push -u origin update-readme

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

Шаг 5: Создание запроса на вытягивание

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

Нажмите эту кнопку, и вы перейдете на новую страницу, где сможете создать запрос на перенос в исходный репозиторий. Используйте правильный заголовок и объясните, какие изменения вы внесли в комментарии. Вуаля, вы в одном клике от вашей первой публикации с открытым исходным кодом.

Вот и все. Вам нужно подождать, пока кто-нибудь одобрит ваш запрос на перенос. Как только они это сделают, вы сможете увидеть изменения в исходном репозитории.

Бонус: синхронизация вилки

Если у вас есть только один или два вклада, форк может быть удален после слияния PR. В противном случае вам придется регулярно обновлять вилку с учетом изменений в исходном репо. Для этого вам нужно добавить в свой клон еще один пульт. Перейдите в исходный репозиторий и получите URL-адрес клона, как мы это делали ранее.

Этот пульт обычно называется восходящим потоком. У вас будет доступ только для чтения с этого пульта ДУ. Добавьте новый пульт.

git remote add upstream <original-repo-url>

Например,

git remote add upstream https://github.com/hadeeb/react-lazy-hydration.git

Теперь слушайте внимательно, у вас на клоне два пульта ДУ. Во-первых, источник указывает на вашу вилку, а восходящий поток указывает на исходный репозиторий. Итак, в основном то, что вы собираетесь сделать, - это извлечь изменения из восходящего потока и протолкнуть их в источник.

Предполагая, что вы находитесь в главной ветке. Если нет, переключитесь.

git checkout master

Тяните вверх по течению.

git pull upstream master

Нажмите на источник.

git push origin master

Итак, вы только что синхронизировали вилку с исходным репозиторием.

Подводя итоги того, что мы сделали,

  • Создайте вилку проекта.
  • Клонируйте и настройте рабочую копию в вашей системе.
  • Создайте новую ветку и внесите свои изменения,
  • Опубликуйте изменения в своей вилке.
  • Создайте запрос на перенос.

Теперь вы готовы к участию в проектах с открытым исходным кодом. Они очень важны для вас как разработчика. Это поможет вам изучить общественные стандарты, узнать что-то новое и познакомиться с реальным миром. Если вы хотите попрактиковаться в выполнении пул-реквестов перед тем, как приступить к реальному проекту, я предлагаю вам взглянуть на этот проект. Он предназначен исключительно для того, чтобы помочь людям сделать первый вклад.

Удачного кодирования!