Udostępnij za pośrednictwem

Hacktoberfest i inne wydarzenia hackathonowe

Hacktoberfest jest corocznym wydarzeniem na całym świecie odbywa się w październiku. Zdarzenie zachęca deweloperów open source do współtworzenia repozytoriów poprzez pull requesty (PR). Usługa GitHub hostuje wiele repozytoriów typu open source, które współtworzyją zawartość usługi Microsoft Learn. Kilka repozytoriów aktywnie uczestniczy w Hacktoberfest.

Jak współtworzyć

Aby móc współtworzyć repozytorium typu open source, musisz najpierw skonfigurować konto, aby współtworzyć usługę Microsoft Learn. Jeśli dopiero zaczynasz korzystać z tego procesu, zacznij od utworzenia konta usługi GitHub. Pamiętaj, aby zainstalować narzędzie Git i narzędzia języka Markdown.

Aby uzyskać kredyt na udział, zarejestruj się w Hacktoberfest i przeczytaj swój przewodnik uczestnictwa.

Znajdź repozytorium, które wymaga Twojej pomocy

Zespół PowerShell-Docs wspiera wkłady do Hacktoberfest w kilku repozytoriach dokumentacji PowerShell. Zdefiniowaliśmy zestaw zadań oczyszczania, zaprojektowany tak, aby był prosty dla osób rozpoczynających współpracę. Pełne informacje można znaleźć w Hacktoberfest meta-issue.

Aby pomyślnie wykonać te zadania, należy wykonać następujące czynności:

  • Ogólna wiedza na temat składni programu PowerShell
  • Znajomość splattingu
  • Umiejętność czytania i śledzenia przewodnika stylu PowerShell-Docs oraz listy kontrolnej redakcyjnej .
  • Podstawowa znajomość języka Markdown

Przed rozpoczęciem współpracy należy przeczytać meta-kwestię. Gdy wszystko będzie gotowe do rozpoczęcia, otwórz nowy program Hacktoberfest przy użyciu jednego z następujących linków:

Oczekiwania dotyczące jakości

Aby pomyślnie współtworzyć repozytorium Microsoft Learn typu open source, utwórz ważne i znaczące zapytanie pull request. Następujące przykłady z oficjalnej witryny Hacktoberfest są uważane za wkłady niskiej jakości :

  • Prośby o połączenie zawierające zmiany zbiorcze wygenerowane automatycznie
    • Przykład: skryptowane pull requesty w celu usunięcia spacji, poprawienia typowych błędów w pisowni lub zoptymalizowania obrazów
    • Najpierw prześlij problem opisujący automatyczne zmiany, które chcesz wprowadzić
  • Żądania ściągnięcia uznane za destrukcyjne (na przykład przejęcie lub skopiowanie gałęzi lub zatwierdzeń innej osoby i tworzenie żądania ściągnięcia)
  • PR-y uznane za przeszkodę w porównaniu do pomocy
  • Pull requesty, które wyraźnie są próbą zwiększenia liczby pull requestów w październiku

Utwórz żądanie ściągnięcia

żądania pull umożliwiają współautorowi zaproponowanie zestawu zmian. Pomyślne pull requesty mają następujące typowe cechy:

  • PR 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 pull request bez odpowiedniego zgłoszenia, najpierw utwórz zgłoszenie. Aby uzyskać więcej informacji, zobacz GitHub: Informacje o pull requestach.

Zobacz też

  • Last updated on