Hacktoberfest und Microsoft Learn

Hacktoberfest ist ein jährliches weltweites Ereignis, das im Oktober stattfindet. Die Veranstaltung soll dazu beitragen, dass Open-Source-Entwickler über Pull Requests (PR) an Repositorys mitwirken. GitHub hostet viele Open Source-Repositorys, die zu Microsoft Learn-Inhalten beitragen. Einige der Repositorys nehmen aktiv am Hacktoberfest-Ereignis teil. In diesem Artikel erfahren Sie, wie Sie feststellen, welche Repositorys PRs akzeptieren und was Sie als Mitwirkender erwarten können.

Suchen nach einem Repository

Um zu kennzeichnen, ob ein Microsoft Learn Repository am Hacktoberfest teilnimmt, wird das hacktoberfest-Thema im Projekt angezeigt.

GitHub .NET docs repository with hacktoberfest topic.

Informationen zum Filtern aller Microsoft Learn- und .NET-Repositories, die das Thema Hacktoberfest enthalten, finden Sie unter GitHub-Themen: Hacktoberfest.

Alternativ kann ein Repository stattdessen die Bezeichnung Hacktoberfest verwenden. Diese Bezeichnung ist praktisch für Filtervorgänge. Weitere Informationen finden Sie unter Filtervorgänge und Pull Requests nach Bezeichnungen.

Tipp

Wenn Sie ein Repository-Administrator sind und Ihrem Repository die Teilnahme am Hacktoberfest erlauben wollen, fügen Sie das hacktoberfest-Thema zum Repository hinzu. Weitere Informationen finden Sie unter Klassifizieren Ihres Repositorys mit Themen.

Mitwirken

Um zu einem Open Source-Repository beizutragen, müssen Sie zuerst Ihr Konto so konfigurieren, dass es zu Microsoft Learn beiträgt. Wenn Sie diesen Vorgang noch nie abgeschlossen haben, registrieren Sie sich zunächst für ein GitHub-Konto. Sie müssen auch ein Profil registrieren, um Ihre Bemühungen zu verfolgen. Siehe Hacktoberfest.

Nachdem Ihr Konto konfiguriert wurde, lesen Sie zunächst die Datei CONTRIBUTING.md im Stammverzeichnis des Repositorys durch, an dem Sie mitwirken möchten. Diese Dateien dienen als Leitfaden für die Mitwirkung. Im Folgenden finden Sie einige Beispielleitfäden für Mitwirkende aus einigen beliebten Microsoft Learn-Repositories:

Wenn ein Repository zusätzlich zur beitragenden Markdown-Datei eine Datei CODE_OF_CONDUCT.md enthält, ist es eine Voraussetzung, dass das erwartete Verhalten in der Community eingehalten wird. Auch hier einige allgemeine Beispiele:

Weitere Informationen finden Sie unter Hacktoberfest: Teilnahme.

Wählen Sie ein Problem aus.

Um ein Thema zu finden, an dem Sie in einem teilnehmenden Repository mitwirken möchten, filtern Sie die Themen entweder nach den GitHub-Bezeichnungen up-for-grabs oder help-wanted. Sie können zwar auch mit anderen Themen mitwirken, aber es ist einfacher, sich auf Themen zu konzentrieren, die einen klar definierten Umfang haben und in sich abgeschlossen sind. Zusätzlich zu den Microsoft Learn-Repositories können Sie die folgenden Websites für Einsteiger verwenden:

Weitere Informationen finden Sie unter Hacktoberfest: Einsteiger.

Qualitätserwartungen

Um mit einem erfolgreichen Beitrag an einem Open Source-Microsoft Learn-Repository mitzuwirken, erstellen Sie einen aussagekräftigen und wirkungsvollen PR. Die folgenden Beispiele von der offiziellen Hacktoberfest-Website gelten als qualitativ geringwertige Beiträge:

  • PRs, die automatisiert sind (z. B. geskriptete PRs, die Leerzeichen entfernen, Rechtschreibfehler korrigieren oder Bilder optimieren).
  • PRs, die störend sind (z. B. Verwendung eines Branch oder Commits eines anderen Benutzers und Erstellung eines PRs).
  • PRs, die von einem Projektverantwortlichen als Hindernis und nicht als Hilfe betrachtet werden.
  • Ein Beitrag, der eindeutig darauf abzielt, Ihre PR-Anzahl für Oktober zu erhöhen.

Schließlich ist ein PR zur Korrektur eines Schreibfehlers in Ordnung, aber fünf PRs zur Entfernung eines Leerzeichens sind es nicht.

Weitere Informationen finden Sie unter Hacktoberfest: Werte.

Öffnen eines PR

Ein PR bietet einem Mitwirkenden eine praktische Möglichkeit, eine Reihe von Änderungen vorzuschlagen. Geben Sie beim Öffnen eines PR im ursprünglichen Kommentar an, dass er zum hacktoberfest beitragen soll. Erfolgreiche PRs weisen die folgenden allgemeinen Merkmale auf:

  • Der PR bedeutet einen Mehrwert.
  • Der Mitwirkende ist für Feedback offen.
  • Die beabsichtigten Änderungen sind gut formuliert.
  • Die Änderungen beziehen sich auf ein vorhandenes Problem.

Wenn Sie einen PR ohne entsprechendes Problem vorschlagen, erstellen Sie zunächst ein Problem. Weitere Informationen finden Sie unter GitHub: Informationen zu Pull Requests.

Siehe auch

  • Last updated on