So öffnen Sie einen Pull-Request auf GitHub

So öffnen Sie einen Pull-Request auf GitHub

Ein Pull Request (PR) ist eine GitHub-Funktion, mit der Sie Änderungen an einem Repository vorschlagen können, auf das Sie keinen Schreibzugriff haben. Die Repository-Betreuer können diese Änderungen überprüfen und sie bei Bedarf mit dem ursprünglichen Repository zusammenführen.

Das Öffnen von Pull Requests auf GitHub ist entscheidend, um zu Open-Source-Projekten beizutragen und mit anderen Entwicklern zusammenzuarbeiten. Erfahren Sie, wie Sie in wenigen einfachen Schritten eine Pull-Anforderung auf GitHub erstellen und öffnen.

Schritt 1: Forken des Repositorys

Durch das Forken eines Repositorys auf der GitHub-Plattform wird eine Kopie – auch als „Fork“ bezeichnet – dieses Repositorys unter Ihrem Konto erstellt. Durch das Forking eines Repositorys können Sie Änderungen am Code vornehmen, ohne das ursprüngliche Repository zu beeinträchtigen.

Um ein Repository zu forken, navigieren Sie zu seiner Hauptseite und klicken Sie auf die Fork – Schaltfläche in der oberen rechten Ecke:

Hervorgehobene GitHub-Fork-Schaltfläche

Geben Sie den Repository-Namen (Fork) und eine optionale Beschreibung ein und klicken Sie auf Fork erstellen :

Ein GitHub-Formular zum Erstellen eines neuen Forks

Jetzt haben Sie eine Kopie des ursprünglichen Repositorys erstellt. Dieses neue Repository hat eine Verbindung mit dem Original, sodass alle Änderungen, die Sie am Code vornehmen, einfach verglichen und wieder mit ihm zusammengeführt werden können.

Schritt 2: Änderungen am Code vornehmen

Nachdem Sie das Repository gegabelt haben, müssen Sie es möglicherweise auf Ihren lokalen Computer klonen, abhängig von der Menge und Art der Änderungen, die Sie vorschlagen möchten. Wenn Sie sehr einfache Änderungen vornehmen, die Sie nicht testen müssen, können Sie dies online mit dem webbasierten GitHub-Editor tun .

Führen Sie diesen Terminalbefehl aus, um ein Repository mit Git auf Ihren lokalen Computer zu klonen:

git clone <REPOSITORY_URL>

Ersetzen Sie <REPOSITORY_URL> durch die URL Ihres Repositorys – Sie finden diese auf GitHub. Dieser Befehl klont das Repository auf Ihren lokalen Computer, wo Sie frei experimentieren und Änderungen am Code vornehmen können.

Sie sollten Ihre Änderungen klein und konzentriert halten, da große Pull-Requests schwer zu überprüfen und zusammenzuführen sind. Versuchen Sie, Ihre Änderungen spezifisch für ein Problem oder eine Funktion zu halten, damit die Betreuer sie leichter überprüfen und akzeptieren können.

Nachdem Sie die gewünschten Änderungen lokal vorgenommen haben, übertragen Sie sie und übertragen Sie sie mit Git auf Ihren GitHub-Fork.

Schritt 3: Öffnen einer Pull-Anfrage

Nachdem Sie Ihre Änderungen an GitHub übergeben haben, sollten Sie eine Eingabeaufforderung sehen, die Sie darauf hinweist, dass Ihr Branch eine Reihe von „Commits“ vor dem Repository liegt, von dem Sie ihn gegabelt haben, zum Beispiel:

Eine GitHub-Nachricht, die ein Projekt vor seinem Upstream-Repository zeigt.

Klicken Sie auf das Dropdown-Menü Beitragen . Wenn Sie auf diese Schaltfläche klicken, werden Sie aufgefordert, eine Pull-Anforderung zu öffnen. Klicken Sie dann auf die Schaltfläche Pull-Anfrage öffnen :

GitHub-Repository-Hauptseite mit hervorgehobener Pull-Request-Schaltfläche öffnen

Einige Repositorys haben spezifische Beitragsrichtlinien, die Sie normalerweise in einer CONTRIBUTING.md-Datei finden, die Sie befolgen müssen. Lesen und befolgen Sie unbedingt diese Richtlinien, bevor Sie eine Pull-Anfrage senden.

Füllen Sie als Nächstes die erforderlichen Felder aus und klicken Sie auf die Schaltfläche Pull Request erstellen :

Ein GitHub-Pull-Request-Formular mit hervorgehobener Schaltfläche „Erstellen“.

Ihre Commit-Nachricht sollte klar und prägnant sein und die von Ihnen vorgenommenen Änderungen und die Gründe dafür beschreiben. Dies hilft Betreuern, Ihre Änderungen zu verstehen, und erleichtert ihnen die Überprüfung des Codes.

Sobald Sie Ihren Pull erstellt haben, müssen Sie warten, bis die Betreuer des Projekts ihn überprüft und zusammengeführt oder geschlossen haben. Die Betreuer haben möglicherweise Vorschläge oder Feedback zu Ihrer Pull-Anfrage. Seien Sie offen für Änderungen und bereit, Überarbeitungen vorzunehmen, wenn Sie darum gebeten werden.

Die Bedeutung von Pull-Requests

Pull Requests erleichtern die Zusammenarbeit zwischen Entwicklern, indem sie ihnen ermöglichen, Änderungen vorzuschlagen, Feedback zu geben und Code zu überprüfen. Dies trägt dazu bei, das Gemeinschaftsgefühl und die Zusammenarbeit innerhalb eines Projekts zu fördern, was zu mehr Beiträgen und einer schnelleren Entwicklung führt.

Darüber hinaus organisieren Pull Requests den Verlauf und die Versionierung des Projekts, indem sie es Betreuern ermöglichen, die verschiedenen Versionen des Codes und die an jeder Version vorgenommenen Änderungen zu verfolgen.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert