Hacktoberfest to coroczne, trwające miesiąc święto projektów open source, opiekunów i współpracowników. Wydarzenie ma na celu promowanie otwartego oprogramowania i zachęcanie programistów do wnoszenia wkładu.
Hacktoberfest oferuje zachęty dla pierwszych 40 000 uczestników, którzy do 31 października otrzymają cztery pull requesty. Możesz albo zasadzić drzewo na swoje imię, albo koszulkę Hacktoberfest.
Wszystko zaczyna się od pierwszego żądania ściągnięcia/scalenia.
Rejestracja na Hacktoberfest
Aby wziąć udział w Hacktoberfest, należy najpierw zarejestrować się na wydarzenie w dniu hacktoberfest.com.
Zobaczysz ekran podobny do tego:
Aby wziąć udział, musisz mieć konto GitHub lub GitLab.
Wybierz preferowaną usługę hostingową i kliknij ZAINICJOWAĆ przycisk. Kliknięcie tego przycisku przekieruje Cię do wybranej aplikacji, która poprosi Cię o zatwierdzenie Hacktoberfest.
Autoryzacja Hacktoberfest automatycznie zarejestruje Cię na wydarzenie.
Znajdowanie projektów do współtworzenia w GitHub i GitLab
Tylko wkłady do uczestniczących projektów open source na
GitHub czy GitLab będzie się liczyć na Hacktoberfest. Aby wziąć udział, musisz mieć konto GitHub lub GitLab.GitHub
Aby znaleźć projekty biorące udział w Hacktoberfest na GitHub:
- Nawigować do github.com.
- Przejdź do paska wyszukiwania w GitHub lub naciśnij ukośnik (/) na klawiaturze.
- Wpisz „Hacktoberfest” i kliknij WCHODZIĆ przycisk.
Wykonanie powyższych kroków spowoduje wyświetlenie kilku wyników, z tematem Hacktoberfest na samej górze. W tym temacie znajdziesz listę repozytoriów, w których możesz współtworzyć, jak pokazano na poniższym obrazku.
Alternatywnie możesz przejść bezpośrednio do GitHub Hacktoberfest temat.
GitLab
Aby znaleźć projekty biorące udział w Hacktoberfest na GitLab:
- Nawigować do gitlab.com.
- Na stronie głównej wybierz przeglądać projekty publiczne.
- Na stronie Eksploruj projekty wybierz eksploruj tematy.
- w filtruj według wyszukiwania wpisz „Hacktoberfest”.
Wykonanie powyższych kroków spowoduje wyświetlenie kilku wyników, z tematem Hacktoberfest jako pierwszym. W tym temacie znajdziesz listę repozytoriów, w których możesz współtworzyć, jak pokazano na poniższym obrazku.
Alternatywnie możesz przejść bezpośrednio do GitLab Hacktoberfest temat.
Tworzenie żądania ściągnięcia (PR) na GitHub
Żądanie ściągnięcia (PR) to propozycja złożona przez współtwórcę projektu z prośbą do opiekuna projektu o przejrzenie i połączenie proponowanych zmian w projekcie.
Aby zrobić PR, musisz znaleźć projekt Hacktoberfest, do którego chcesz się przyczynić. Po znalezieniu projektu kliknij przycisk widelec przycisk w prawym górnym rogu:
Rozwidlenie projektu tworzy kopię projektu na Twoim koncie GitHub, umożliwiając wprowadzanie zmian bez wpływu na główny projekt. Po rozwidleniu projektu sklonuj repozytorium ze swojego konta i wprowadź zmiany w lokalnym środowisku programistycznym.
Pamiętaj, aby przeczytać wytyczne dotyczące wkładu w projekt i postępować zgodnie z nimi, aby zwiększyć szanse na żądanie ściągnięcia.
Po wprowadzeniu zmian i dodaniu rozwidlonej wersji repozytorium, zatwierdź zmiany za pomocą Giti wypchnij je do GitHub.
Kiedy zmiany zostaną odzwierciedlone w GitHub, otrzymasz monit informujący, że twój fork „commituje” przed główną gałęzią, jak pokazano na poniższym obrazku.
Następnie kliknij brać w czymś udział przycisk w monicie. Kliknięcie tego przycisku spowoduje wyświetlenie monitu o otwarcie żądania ściągnięcia, jak pokazano na poniższym obrazku.
Następnie kliknij na otwarte żądanie ściągnięcia przycisk. Spowoduje to przejście do strony, na której przejrzysz wytyczne dotyczące wkładu oraz tytuł i opis żądania ściągnięcia.
Wypełnij wymagane pola i kliknij na Utwórz żądanie ściągnięcia przycisk, jak pokazano na poniższym obrazku.
Utworzyłeś żądanie ściągnięcia. Teraz poczekaj, aż opiekunowie projektu przejrzą i połączą lub odrzucą Twój wkład.
Tworzenie żądania scalania w GitLab
Żądanie scalenia jest identyczne z żądaniem ściągnięcia. Jedyną różnicą są ich nazwy.
Aby złożyć wniosek o połączenie, musisz najpierw znaleźć projekt Hacktoberfest, w którym chcesz wziąć udział. Po znalezieniu projektu kliknij przycisk rozwidlenia w prawym górnym rogu:
Rozwidlenie projektu tworzy kopię projektu na Twoim koncie GitLab, umożliwiając wprowadzanie zmian bez wpływu na główny projekt. Po rozwidleniu projektu sklonuj repozytorium ze swojego konta i wprowadź zmiany w lokalnym środowisku programistycznym.
Pamiętaj, aby przeczytać wytyczne dotyczące wkładu w projekt i postępować zgodnie z nimi, aby zwiększyć szanse na żądanie ściągnięcia.
Po wprowadzeniu zmian i dodaniu rozwidlonej wersji repozytorium zatwierdź zmiany i wypchnij je do GitLab.
Po przesłaniu zmian do GitLab przejdź do rozwidlonego projektu i kliknij Żądania scalania na pasku bocznym. Spowoduje to wyświetlenie ekranu wyjaśniającego prośbę o scalenie i a Nowa prośba o połączenie przycisk. Kliknij Nowa prośba o połączenie przycisk, jak pokazano na poniższym obrazku.
Następnie musisz wybrać a źródło I cel oddział. The źródło branch powinna być gałęzią, w której znajdują się zmiany, które chcesz zatwierdzić w głównym repozytorium. The cel branch powinno być głównym repozytorium, w którym chcesz zatwierdzić zmiany. Po wybraniu oddziałów kliknij na Porównaj gałęzie i kontynuuj przycisk, jak pokazano na poniższym obrazku.
Klikając Porównaj gałęzie i kontynuuj przeniesie Cię do strony, na której możesz wprowadzić tytuł i opis prośby o scalenie.
Wypełnij wymagane dane i kliknij Utwórz przycisk prośby o scalenie, jak pokazano na poniższym obrazku.
Kliknięcie tego przycisku powoduje utworzenie żądania scalenia. Teraz musisz poczekać, aż opiekunowie projektu przejrzą i połączą lub zamkną żądanie ściągnięcia.
Regulamin Hacktoberfest
Wszystkie wkłady w projekty Hacktoberfest muszą mieścić się w granicach Hacktoberfest i nie mogą być spamem. Nieprzestrzeganie zasad Hacktoberfest może skutkować dyskwalifikacją z imprezy.
Hacktoberfest wystawia siedmiodniowy okres weryfikacji żądań ściągnięcia/połączenia, które są zgodne ze wszystkimi wytycznymi. Jeśli twój PR jest dobry, projekt powinien przyjąć go na Hacktoberfest w tym terminie.
Miłego wkładu!
