Hacktoberfest е ежегоден едномесечен празник на проекти с отворен код, поддържащи и сътрудници. Събитието има за цел да популяризира отворен код и да насърчи разработчиците да дадат своя принос.
Hacktoberfest идва със стимули за първите 40 000 участници, които получат четири заявки за изтегляне, обединени до 31 октомври. Можете или да получите дърво, засадено на ваше име, или тениска на Hacktoberfest.
Всичко започва с първата ви заявка за изтегляне/сливане.
Регистрация за Hacktoberfest
За да участвате в Hacktoberfest, първо трябва да се регистрирате за събитието на hacktoberfest.com.
Ще видите екран, подобен на този:
Трябва да имате акаунт в GitHub или GitLab, за да участвате.
Изберете предпочитаната от вас хостинг услуга и щракнете върху ИНИЦИАЦИЯ бутон. Щракването върху този бутон ще ви пренасочи към избраното от вас приложение, което ще ви помоли да одобрите Hacktoberfest.
Упълномощаването на Hacktoberfest автоматично ще ви регистрира за събитието.
Намиране на проекти за принос в GitHub & GitLab
Само приноси към участващи проекти с отворен код на GitHub или GitLab ще се брои за Hacktoberfest. Трябва да имате акаунт в GitHub или GitLab, за да участвате.
GitHub
За да намерите проекти, участващи в Hacktoberfest в GitHub:
- Навигирайте до github.com.
- Отидете до лентата за търсене на GitHub или натиснете клавиша с наклонена черта (/) на вашата клавиатура.
- Въведете „Hacktoberfest“ и щракнете върху ENTER бутон.
Следвайки стъпките по-горе, ще се покажат няколко резултата, като темата Hacktoberfest е най-отгоре. Тази тема ще ви даде списък с хранилища, към които можете да допринесете, както е показано на изображението по-долу.
Като алтернатива можете директно да отидете на GitHub Hacktoberfest тема.
GitLab
За да намерите проекти, участващи в Hacktoberfest в GitLab:
- Навигирайте до gitlab.com.
- На началната страница изберете проучете обществени проекти.
- На страницата за изследване на проекти изберете изследвайте теми.
- В филтър по търсене въведете „Hacktoberfest“.
Следвайки стъпките по-горе, ще се покажат няколко резултата, с темата Hacktoberfest като първата. Тази тема ще ви даде списък с хранилища, към които можете да допринесете, както е показано на изображението по-долу.
Като алтернатива можете директно да отидете на GitLab Hacktoberfest тема.
Създаване на заявка за изтегляне (PR) в GitHub
Заявката за изтегляне (PR) е предложение, направено от участник в проект, което иска от поддържащия проекта да прегледа и обедини предложените промени в проекта.
За да направите PR, трябва да намерите проект на Hacktoberfest, за който искате да допринесете. След като намерите проект, щракнете върху вилица бутон в горния десен ъгъл:
Разклоняването на проект създава копие на проекта във вашия акаунт в GitHub, което ви позволява да правите промени, без да засягате основния проект. След разклоняването на проекта, клонирайте хранилището от вашия акаунт и направете промените във вашата локална среда за разработка.
Не забравяйте да прочетете насоките за принос на проекта и да ги следвате, за да увеличите шансовете за вашата заявка за изтегляне.
След като направите промените и добавите вашата разклонена версия на хранилището, ангажирайте промените с помощта на Gitи ги изпратете към GitHub.
Когато промените се отразят на GitHub, ще получите подкана, която ви информира, че вашето разклонение е „commits“ преди главния клон, както е показано на изображението по-долу.
След това щракнете върху допринасят бутон на подканата. Щракването върху този бутон ще ви подкани да отворите заявка за изтегляне, както е показано на изображението по-долу.
След това щракнете върху отворена заявка за изтегляне бутон. Това ще ви отведе до страница, където ще прегледате насоките за принос и заглавие и описание на вашата заявка за изтегляне.
Попълнете задължителните полета и щракнете върху Създайте заявка за изтегляне бутон, както е показано на изображението по-долу.
Създадохте заявка за изтегляне. Сега изчакайте поддържащите проекта да прегледат и обединят или отхвърлят вашия принос.
Създаване на заявка за сливане в GitLab
Заявката за сливане е идентична на заявката за изтегляне. Единствената разлика са съответните им имена.
За да направите заявка за сливане, първо трябва да намерите проект на Hacktoberfest, за който искате да допринесете. След като намерите проект, щракнете върху бутона за разклонение в горния десен ъгъл:
Разклоняването на проект създава копие на проекта във вашия акаунт в GitLab, което ви позволява да правите промени, без да засягате основния проект. След разклоняването на проекта, клонирайте хранилището от вашия акаунт и направете промените във вашата локална среда за разработка.
Не забравяйте да прочетете насоките за принос на проекта и да ги следвате, за да увеличите шансовете за вашата заявка за изтегляне.
След като направите промените и добавите вашата разклонена версия на хранилището, ангажирайте промените и ги бутнете към GitLab.
След като изпратите промените си в GitLab, отидете до вашия разклонен проект и щракнете Заявки за сливане в страничната лента. Това ще покаже екран, обясняващ заявка за сливане и a Нова заявка за сливане бутон. Щракнете върху Нова заявка за сливане бутон, както е показано на изображението по-долу.
След това ще трябва да изберете a източник и мишена клон. The източник клонът трябва да бъде клонът, където се намират промените, които искате да ангажирате към главното хранилище. The мишена клонът трябва да бъде основното хранилище, където искате да извършите промените си. След като изберете клоновете, щракнете върху Сравнете клоновете и продължете бутон, както е показано на изображението по-долу.
Щраквайки върху Сравнете клоновете и продължете ще ви отведе до страница, където можете да въведете заглавие и описание за вашата заявка за сливане.
Попълнете необходимите данни и щракнете върху Бутон за създаване на заявка за сливане, както е показано на изображението по-долу.
Щракването върху този бутон създава вашата заявка за сливане. Сега трябва да изчакате поддържащите проекта да прегледат и обединят или затворят вашата заявка за изтегляне.
Правила и условия на Hacktoberfest
Всички приноси, направени към проекти на Hacktoberfest, трябва да бъдат в рамките на Hacktoberfest и да не са спам. Неспазването на правилата на Hacktoberfest може да доведе до дисквалификация от събитието.
Hacktoberfest издава седемдневен период за преглед на заявки за изтегляне/сливане, които следват всички указания. Ако вашият PR е добър, проектът трябва да го приеме за Hacktoberfest в рамките на този срок.
Честит принос!
