Das Hacktoberfest ist eine jährliche, einmonatige Feier von Open-Source-Projekten, -Betreuern und -Mitwirkenden. Die Veranstaltung zielt darauf ab, Open Source zu fördern und Entwickler zu ermutigen, sich zu beteiligen.
Das Hacktoberfest bietet Anreize für die ersten 40.000 Teilnehmer, die bis zum 31. Oktober vier Pull-Requests zusammenführen. Du kannst entweder einen Baum in deinem Namen pflanzen lassen oder ein Hacktoberfest-T-Shirt.
Alles beginnt mit Ihrer ersten Pull-/Merge-Anfrage.
Anmeldung zum Hacktoberfest
Um am Hacktoberfest teilnehmen zu können, müssen Sie sich zunächst für die Veranstaltung auf registrieren hacktoberfest.com.
Sie sehen einen ähnlichen Bildschirm wie diesen:
Sie müssen über ein GitHub- oder GitLab-Konto verfügen, um teilnehmen zu können.
Wählen Sie Ihren bevorzugten Hosting-Service und klicken Sie auf EINLEITEN Taste. Wenn Sie auf diese Schaltfläche klicken, werden Sie zu Ihrer ausgewählten Anwendung weitergeleitet, in der Sie aufgefordert werden, das Hacktoberfest zu genehmigen.
Wenn Sie das Hacktoberfest autorisieren, werden Sie automatisch für die Veranstaltung registriert.
Auf GitHub & GitLab nach Projekten suchen, an denen Sie mitwirken können
Nur Beiträge zu teilnehmenden Open-Source-Projekten auf GitHub oder GitLab zählen für das Hacktoberfest. Sie müssen über ein GitHub- oder GitLab-Konto verfügen, um teilnehmen zu können.
GitHub
So finden Sie Projekte, die am Hacktoberfest auf GitHub teilnehmen:
- Navigieren Sie zu github.com.
- Navigieren Sie zur Suchleiste auf GitHub oder drücken Sie die Schrägstrichtaste (/) auf Ihrer Tastatur.
- Geben Sie „Hacktoberfest“ ein und klicken Sie auf die EINGEBEN Taste.
Wenn Sie den obigen Schritten folgen, werden mehrere Ergebnisse angezeigt, wobei das Hacktoberfest-Thema ganz oben steht. Dieses Thema gibt Ihnen eine Liste von Repositories, zu denen Sie beitragen können, wie in der Abbildung unten gezeigt.
Alternativ können Sie auch direkt zum gehen GitHub Hacktoberfest Thema.
GitLab
So finden Sie Projekte, die am Hacktoberfest auf GitLab teilnehmen:
- Navigieren Sie zu gitlab.com.
- Wählen Sie auf der Startseite aus Erkunden Sie öffentliche Projekte.
- Wählen Sie auf der Seite „Projekte erkunden“ aus Themen erkunden.
- Im nach Suche filtern Geben Sie „Hackoberfest“ ein.
Wenn Sie den obigen Schritten folgen, werden mehrere Ergebnisse angezeigt, wobei das Hacktoberfest-Thema das allererste ist. Dieses Thema gibt Ihnen eine Liste von Repositories, zu denen Sie beitragen können, wie in der Abbildung unten gezeigt.
Alternativ können Sie auch direkt zum gehen GitLab Hacktoberfest Thema.
Erstellen einer Pull-Anforderung (PR) auf GitHub
Ein Pull-Request (PR) ist ein Vorschlag, der von einem Mitwirkenden an einem Projekt gemacht wird und den Betreuer des Projekts auffordert, vorgeschlagene Änderungen am Projekt zu prüfen und zusammenzuführen.
Um eine PR zu erstellen, müssen Sie ein Hacktoberfest-Projekt finden, zu dem Sie beitragen möchten. Wenn Sie ein Projekt gefunden haben, klicken Sie auf Gabel Schaltfläche in der oberen rechten Ecke:
Beim Forking eines Projekts wird eine Kopie des Projekts in Ihrem GitHub-Konto erstellt, sodass Sie Änderungen vornehmen können, ohne das Hauptprojekt zu beeinträchtigen. Klonen Sie nach dem Forken des Projekts das Repository von Ihrem Konto und nehmen Sie die Änderungen in Ihrer lokalen Entwicklungsumgebung vor.
Lesen Sie unbedingt die Beitragsrichtlinien des Projekts und befolgen Sie sie, um die Chancen auf Ihre Pull-Anfrage zu erhöhen.
Nachdem Sie die Änderungen vorgenommen und Ihre gegabelte Version des Repositorys hinzugefügt haben, Committen Sie die Änderungen mit Git, und pushen Sie sie auf GitHub.
Wenn die Änderungen auf GitHub widergespiegelt werden, erhalten Sie eine Eingabeaufforderung, die Sie darüber informiert, dass Ihr Fork vor dem Hauptzweig „committ“, wie in der Abbildung unten gezeigt.
Klicken Sie anschließend auf die beitragen Schaltfläche auf der Eingabeaufforderung. Wenn Sie auf diese Schaltfläche klicken, werden Sie aufgefordert, eine Pull-Anforderung zu öffnen, wie in der Abbildung unten gezeigt.
Klicken Sie dann auf die Pull-Request öffnen Taste. Dadurch gelangen Sie zu einer Seite, auf der Sie die Beitragsrichtlinien sowie einen Titel und eine Beschreibung für Ihren Pull-Request überprüfen.
Füllen Sie die erforderlichen Felder aus und klicken Sie auf die Pull-Request erstellen Taste, wie im Bild unten gezeigt.
Sie haben einen Pull-Request erstellt. Warten Sie nun, bis die Betreuer des Projekts Ihren Beitrag überprüft und zusammengeführt oder abgelehnt haben.
Erstellen einer Zusammenführungsanforderung auf GitLab
Ein Merge-Request ist identisch mit einem Pull-Request. Der einzige Unterschied besteht in den jeweiligen Namen.
Um eine Zusammenführungsanfrage zu stellen, müssen Sie zuerst ein Hacktoberfest-Projekt finden, zu dem Sie beitragen möchten. Sobald Sie ein Projekt gefunden haben, klicken Sie auf die Fork-Schaltfläche in der oberen rechten Ecke:
Beim Forking eines Projekts wird eine Kopie des Projekts in Ihrem GitLab-Konto erstellt, sodass Sie Änderungen vornehmen können, ohne das Hauptprojekt zu beeinträchtigen. Klonen Sie nach dem Forken des Projekts das Repository von Ihrem Konto und nehmen Sie die Änderungen in Ihrer lokalen Entwicklungsumgebung vor.
Lesen Sie unbedingt die Beitragsrichtlinien des Projekts und befolgen Sie sie, um die Chancen auf Ihre Pull-Anfrage zu erhöhen.
Nachdem Sie die Änderungen vorgenommen und Ihre gegabelte Version des Repositorys hinzugefügt haben, übernehmen Sie die Änderungen und pushen Sie sie zu GitLab.
Nachdem Sie Ihre Änderungen an GitLab gepusht haben, navigieren Sie zu Ihrem Fork-Projekt und klicken Sie darauf Anfragen zusammenführen in der Seitenleiste. Dadurch wird ein Bildschirm angezeigt, der eine Zusammenführungsanforderung und a erklärt Neue Zusammenführungsanforderung Taste. Drücke den Neue Zusammenführungsanforderung Taste, wie im Bild unten gezeigt.
Als nächstes müssen Sie eine auswählen Quelle Und Ziel Zweig. Der Quelle branch sollte der Branch sein, in dem sich die Änderungen befinden, die Sie an das Haupt-Repository übertragen möchten. Der Ziel branch sollte das Haupt-Repository sein, in das Sie Ihre Änderungen übertragen möchten. Nachdem Sie die Zweige ausgewählt haben, klicken Sie auf die Filialen vergleichen und weiter Taste, wie im Bild unten gezeigt.
Klicken Sie auf die Filialen vergleichen und weiter Die Schaltfläche führt Sie zu einer Seite, auf der Sie einen Titel und eine Beschreibung für Ihre Zusammenführungsanfrage eingeben können.
Füllen Sie die erforderlichen Details aus und klicken Sie auf Schaltfläche "Zusammenführungsanforderung erstellen", wie im Bild unten gezeigt.
Durch Klicken auf diese Schaltfläche wird Ihre Zusammenführungsanforderung erstellt. Jetzt müssen Sie warten, bis die Betreuer des Projekts Ihre Pull-Anforderung überprüft und zusammengeführt oder geschlossen haben.
Allgemeine Geschäftsbedingungen des Hacktoberfests
Alle Beiträge zu Hacktoberfest-Projekten müssen innerhalb der Grenzen des Hacktoberfests erfolgen und dürfen nicht spammig sein. Die Nichteinhaltung der Regeln des Hacktoberfestes kann zum Ausschluss von der Veranstaltung führen.
Das Hacktoberfest gibt einen siebentägigen Überprüfungszeitraum für Pull-/Merge-Anfragen heraus, die alle Richtlinien befolgen. Wenn Ihre PR gut ist, sollte das Projekt sie innerhalb dieses Zeitrahmens für das Hacktoberfest akzeptieren.
Viel Spaß beim Beitragen!