Hacktoberfest — это ежегодное месячное празднование проектов с открытым исходным кодом, сопровождающих и участников. Мероприятие направлено на продвижение открытого исходного кода и поощрение разработчиков к участию.
На Hacktoberfest предусмотрены поощрения для первых 40 000 участников, которые до 31 октября объединят четыре пулл-реквеста. Вы можете посадить дерево на свое имя или футболку Hacktoberfest.
Все начинается с вашего первого запроса на слияние/вытягивание.
Регистрация на Хактоберфест
Чтобы принять участие в Hacktoberfest, вы должны сначала зарегистрироваться на мероприятии на hacktoberfest.com.
Вы увидите экран, похожий на этот:
Для участия у вас должна быть учетная запись GitHub или GitLab.
Выберите предпочитаемый хостинг и нажмите кнопку ИНИЦИИРОВАТЬ кнопка. Нажатие этой кнопки перенаправит вас в выбранное вами приложение, которое попросит вас одобрить Hacktoberfest.
Авторизация Hacktoberfest автоматически зарегистрирует вас на мероприятии.
Поиск проектов для участия на GitHub и GitLab
Только вклады в участвующие проекты с открытым исходным кодом на Гитхаб или Гитлаб засчитывается для Hacktoberfest. Для участия у вас должна быть учетная запись GitHub или GitLab.
Гитхаб
Чтобы найти проекты, участвующие в Hacktoberfest, на GitHub:
- Перейдите к github.com.
- Перейдите к строке поиска на GitHub или нажмите клавишу косой черты (/) на клавиатуре.
- Введите «Hacktoberfest» и нажмите кнопку ВХОДИТЬ кнопка.
Выполнение описанных выше шагов отобразит несколько результатов с темой Hacktoberfest в самом верху. В этой теме вы найдете список репозиториев, в которые вы можете внести свой вклад, как показано на изображении ниже.
Кроме того, вы можете напрямую перейти к GitHub Хактоберфест тема.
GitLab
Чтобы найти проекты, участвующие в Hacktoberfest, на GitLab:
- Перейдите к gitlab.com.
- На главной странице выберите исследовать публичные проекты.
- На странице изучения проектов выберите исследовать темы.
- в фильтровать по поиску введите «Хактоберфест».
Выполнение описанных выше шагов отобразит несколько результатов, причем тема Hacktoberfest будет первой. В этой теме вы найдете список репозиториев, в которые вы можете внести свой вклад, как показано на изображении ниже.
Кроме того, вы можете напрямую перейти к GitLab Хактоберфест тема.
Создание запроса на слияние (PR) на GitHub
Запрос на вытягивание (PR) — это предложение, сделанное участником проекта, с просьбой к сопровождающему проекта просмотреть и объединить предложенные изменения в проекте.
Чтобы сделать PR, вы должны найти проект Hacktoberfest, в который хотите внести свой вклад. Как только вы найдете проект, нажмите кнопку вилка кнопка в правом верхнем углу:
Разветвление проекта создает копию проекта в вашей учетной записи GitHub, что позволяет вам вносить изменения, не затрагивая основной проект. После разветвления проекта клонируйте репозиторий из своей учетной записи и внесите изменения в локальную среду разработки.
Обязательно прочитайте правила участия в проекте и следуйте им, чтобы увеличить шансы на получение вашего запроса на включение.
После внесения изменений и добавления вашей разветвленной версии репозитория, зафиксировать изменения с помощью Gitи отправить их на GitHub.
Когда изменения отразятся на GitHub, вы получите уведомление о том, что ваша вилка «зафиксирована» перед основной веткой, как показано на изображении ниже.
Далее нажмите на способствовать кнопка в подсказке. При нажатии на эту кнопку вам будет предложено открыть запрос на вытягивание, как показано на изображении ниже.
Затем нажмите на открытый пулреквест кнопка. Это приведет вас на страницу, где вы просмотрите рекомендации по взносам, а также заголовок и описание вашего запроса на вытягивание.
Заполните необходимые поля и нажмите кнопку Создать запрос на включение кнопку, как показано на изображении ниже.
Вы создали запрос на вытягивание. Теперь подождите, пока сопровождающие проекта просмотрят и объединят или отклонят ваш вклад.
Создание запроса на слияние в GitLab
Мерж-реквест идентичен пулл-реквесту. Единственная разница заключается в их именах.
Чтобы сделать запрос на слияние, вы должны сначала найти проект Hacktoberfest, в который хотите внести свой вклад. Как только вы найдете проект, нажмите кнопку вилки в правом верхнем углу:
Разветвление проекта создает копию проекта в вашей учетной записи GitLab, что позволяет вам вносить изменения, не затрагивая основной проект. После разветвления проекта клонируйте репозиторий из своей учетной записи и внесите изменения в локальную среду разработки.
Обязательно прочитайте правила участия в проекте и следуйте им, чтобы увеличить шансы на получение вашего запроса на включение.
После внесения изменений и добавления разветвленной версии репозитория зафиксируйте изменения и отправить их в GitLab.
После того, как вы отправили свои изменения в GitLab, перейдите к своему разветвленному проекту и нажмите Объединить запросы в боковой панели. Это вызовет экран с объяснением запроса на слияние и Новый мерж-реквест кнопка. Нажмите на Новый мерж-реквест кнопку, как показано на изображении ниже.
Далее вам нужно будет выбрать источник и цель ветвь. источник ветка должна быть веткой, в которой находятся изменения, которые вы хотите зафиксировать в основном репозитории. цель ветка должна быть основным репозиторием, в котором вы хотите зафиксировать свои изменения. После выбора ветвей нажмите кнопку Сравните ветки и продолжите кнопку, как показано на изображении ниже.
Нажав на Сравните ветки и продолжите Кнопка приведет вас на страницу, где вы можете ввести заголовок и описание вашего мерж-реквеста.
Заполните необходимые данные и нажмите кнопку Создать кнопку мерж-реквеста, как показано на изображении ниже.
При нажатии на эту кнопку создается ваш мерж-реквест. Теперь вам нужно дождаться, пока сопровождающие проекта просмотрят и объединят или закроют ваш запрос на извлечение.
Условия Хактоберфеста
Все материалы, сделанные для проектов Hacktoberfest, должны быть в рамках Hacktoberfest и не быть спамом. Несоблюдение правил Хактоберфеста может привести к дисквалификации с мероприятия.
Hacktoberfest устанавливает семидневный период проверки запросов на слияние/вытягивание, которые соответствуют всем рекомендациям. Если ваш PR хорош, проект должен принять его для Hacktoberfest в течение этого периода времени.
Счастливый вклад!
