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
Forken eines Repositorys an die GitHub-Plattform erstellt eine Kopie – auch bekannt als „Fork“ – dieses Repositorys unter Ihrem Konto. 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
Gabel Schaltfläche in der oberen rechten Ecke:Geben Sie den Repository-Namen (fork) und eine optionale Beschreibung ein und klicken Sie darauf Gabel erstellen:
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 tun der webbasierte GitHub-Editor.
Führen Sie diesen Terminalbefehl aus, um ein Repository mit Git auf Ihren lokalen Computer zu klonen:
git Klon
Ersetzen mit der 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 schieben Sie sie auf Ihren GitHub-Fork mit Git.
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:
Drücke den Beitragen Dropdown-Liste. Wenn Sie auf diese Schaltfläche klicken, werden Sie aufgefordert, eine Pull-Anforderung zu öffnen. Klicken Sie dann auf die Pull-Request öffnen Taste:
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 Pull-Request erstellen Taste:
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.
Nachdem 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-Anforderung. 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.