Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


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.

Znajdowanie repozytorium

Aby dowiedzieć się, czy repozytorium Microsoft Learn uczestniczy w Hacktoberfest, zobaczysz temat hacktoberfest w projekcie.

GitHub .NET docs repository with hacktoberfest topic.

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.

Współtworzenie

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.

Wybierz problem

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.

Oczekiwania dotyczące jakości

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).

Otwieranie żądania ściągnięcia

Żą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.

Zobacz też