Hacktoberfest i Microsoft Learn
Hacktoberfest jest corocznym wydarzeniem na całym świecie odbywa się w miesiącu października. Zdarzenie zachęca deweloperów open source do współtworzenia repozytoriów za pośrednictwem żądań ściągnięcia (PR). Usługa GitHub hostuje wiele repozytoriów typu open source, które współtworzyją zawartość usługi Microsoft Learn . Niektóre repozytoria aktywnie uczestniczą w wydarzeniu Hacktoberfest. W tym artykule dowiesz się, jak odkryć, które repozytoria akceptują żądania ściągnięcia i czego można oczekiwać jako współautora.
Aby dowiedzieć się, czy repozytorium Microsoft Learn uczestniczy w Hacktoberfest, zobaczysz temat hacktoberfest w projekcie.
Aby filtrować wszystkie repozytoria Microsoft Learn i .NET, które mają temat hacktoberfest , zobacz Tematy usługi GitHub: Hacktoberfest.
Alternatywnie repozytorium może zamiast tego użyć Hacktoberfest
etykiety. Ta etykieta jest wygodna w przypadku problemów z filtrowaniem. Aby uzyskać więcej informacji, zobacz Filtrowanie problemów i żądań ściągnięcia według etykiet.
Porada
Jeśli jesteś administratorem repozytorium i chcesz zezwolić repozytorium na uczestnictwo w programie Hacktoberfest, dodaj hacktoberfest
temat do repozytorium. Aby uzyskać więcej informacji, zobacz Klasyfikowanie repozytorium za pomocą tematów.
Aby współtworzyć repozytorium open source, musisz najpierw skonfigurować konto, aby współtworzyć usługę Microsoft Learn. Jeśli ten proces nigdy nie został ukończony, rozpocznij od zarejestrowania się w celu uzyskania konta usługi GitHub. Musisz również zarejestrować profil, aby śledzić swoje wysiłki. Zobacz Hacktoberfest.
Po skonfigurowaniu konta zacznij od przeczytania i przestrzegania pliku CONTRIBUTING.md w katalogu głównym repozytorium, do którego chcesz współtworzyć. Te pliki służą jako przewodnik podczas współtworzenia. Oto kilka przykładowych przewodników współautorów z niektórych popularnych repozytoriów Microsoft Learn:
Oprócz współtworzenia pliku Markdown, jeśli repozytorium ma plik CODE_OF_CONDUCT.md , jest to wymóg przestrzegania oczekiwanego zachowania w społeczności. Oto kilka typowych przykładów:
Aby uzyskać więcej informacji, zobacz Hacktoberfest: Uczestnictwo.
Aby znaleźć problem do pracy w uczestniczącym repozytorium, przefiltruj problemy dla up-for-grabs
etykiet lub help-wanted
GitHub. Chociaż możesz rozwiązać inne problemy, łatwiej jest skupić się na problemach, które mają dobrze zdefiniowany zakres i są samodzielne. Oprócz repozytoriów microsoft Learn można używać następujących witryn dla początkujących:
Aby uzyskać więcej informacji, zobacz Hacktoberfest: Początkujący.
Aby pomyślnie współtworzeć repozytorium Microsoft Learn typu open source, utwórz znaczące i istotne żądanie ściągnięcia. Następujące przykłady z oficjalnej strony Hacktoberfest są uważane za wkład niskiej jakości:
- Żądania ściągnięcia, które są zautomatyzowane (na przykład skryptowe otwieranie żądania ściągnięcia w celu usunięcia białych znaków, naprawienia literówek lub zoptymalizowania obrazów).
- Żądania ściągnięcia, które są destrukcyjne (na przykład pobieranie gałęzi lub zatwierdzeń innej osoby i wykonywanie żądania ściągnięcia).
- Żądania ściągnięcia, które są uważane przez opiekuna projektu za przeszkodę a pomoc.
- Oczywiście jest to próba po prostu +1 liczba żądań ściągnięcia w październiku.
Na koniec jedno żądanie ściągnięcia, aby naprawić literówkę, jest w porządku, ale pięć żądań ściągnięcia w celu usunięcia bezpańskich białych znaków nie są.
Aby uzyskać więcej informacji, zobacz Hacktoberfest: Values (Hacktoberfest: Wartości).
Żądanie ściągnięcia zapewnia wygodny sposób zaproponowania zestawu zmian przez współautora. Podczas otwierania żądania ściągnięcia określ w oryginalnym komentarzu, że ma on przyczynić się do hacktoberfest. Pomyślne żądania ściągnięcia mają następujące typowe cechy:
- Żądanie ściągnięcia dodaje wartość.
- Współautor jest otwarty na opinie.
- Zamierzone zmiany są dobrze sformułowane.
- Zmiany są związane z istniejącym problemem.
Jeśli proponujesz żądanie ściągnięcia bez odpowiedniego problemu, najpierw utwórz problem. Aby uzyskać więcej informacji, zobacz GitHub: Informacje o żądaniach ściągnięcia.