Fork-Workflows auf GitHub

Stellen Sie sich vor, Sie möchten zu einem Open-Source-Projekt beitragen, haben aber keine Berechtigung, dessen Code direkt zu ändern. Genau hier kommt Forking ins Spiel!

Ein Fork ist einfach eine persönliche Kopie des GitHub-Repositorys einer anderen Person. Sie liegt unter Ihrem eigenen GitHub-Konto und gibt Ihnen volle Kontrolle, um zu experimentieren und Änderungen vorzunehmen, ohne das ursprüngliche Projekt zu beeinflussen.

Der wichtigste Grund für einen Fork eines Repositorys besteht darin, einem Projekt Änderungen vorzuschlagen, wenn Sie keinen direkten Schreibzugriff auf dessen ursprüngliche Codebasis haben.

• Sicheres Experimentieren: Arbeiten Sie an Ihrer Kopie, ohne befürchten zu müssen, das Original zu beschädigen.
• Beitragspfad: Dies ist der übliche Weg, Features oder Fehlerbehebungen für öffentliche Projekte vorzuschlagen.
• Persönliche Projekte: Verwenden Sie einen Fork als Ausgangspunkt für Ihr eigenes verwandtes Projekt.

Ein Repository auf GitHub zu forken ist sehr unkompliziert:

1. Navigieren Sie zum ursprünglichen Repository, das Sie forken möchten.
2. Suchen Sie nach der Schaltfläche „Fork“, die sich normalerweise oben rechts befindet.
3. Klicken Sie auf die Schaltfläche „Fork“. GitHub erstellt anschließend unter Ihrem Konto eine Kopie dieses Repositorys.

Sie haben nun github.com/YOUR_USERNAME/ORIGINAL_REPO_NAME.

Nachdem Sie das Repository auf GitHub geforkt haben, möchten Sie diese Kopie auf Ihren lokalen Computer übertragen, um daran zu arbeiten.

Verwenden Sie den Befehl git clone. Achten Sie jedoch darauf, die URL Ihres Forks und nicht die URL des ursprünglichen Repositorys zu klonen.

Da Sie Ihren Fork nun lokal geklont haben, können Sie wie in jedem anderen Git-Projekt Änderungen vornehmen. Es empfiehlt sich, für Ihr Feature oder Ihren Fix einen neuen Branch zu erstellen.

Nachdem Sie Ihre Änderungen lokal committet haben, müssen Sie sie in Ihren Remote-Fork auf GitHub pushen. Dadurch wird Ihre persönliche Kopie des Repositorys aktualisiert.

Der Remote origin verweist normalerweise auf Ihren Fork.

Während Sie an Ihrem Fork arbeiten, erhält das ursprüngliche Repository (oft „upstream“ genannt) möglicherweise neue Updates. Damit Ihr Fork aktuell bleibt, müssen Sie ihn synchronisieren.

Fügen Sie zunächst das ursprüngliche Repository als neuen Remote mit dem Namen upstream hinzu. Holen Sie anschließend dessen Änderungen ab und mergen Sie sie.

Sobald Ihre Änderungen abgeschlossen und in Ihren Fork gepusht wurden, können Sie sie dem ursprünglichen Projekt vorschlagen. Dies geschieht über einen Pull Request (PR).

Navigieren Sie auf GitHub zu Ihrem Fork. Häufig sehen Sie dort ein Banner, das Sie auffordert, aus Ihrem neuen Branch einen PR zu erstellen. Folgen Sie den Anweisungen, um Ihren Branch mit dem Main-Branch des ursprünglichen Repositorys zu vergleichen und Ihren Vorschlag einzureichen.

Zusammenfassung des typischen Forking-Workflows:

• Fork: Erstellen Sie Ihre persönliche Kopie auf GitHub.
• Clone: Übertragen Sie Ihren Fork auf Ihren lokalen Computer.
• Develop: Nehmen Sie Änderungen in einem neuen Branch vor.
• Push: Senden Sie Ihre Änderungen an Ihren Remote-Fork.
• Sync: Halten Sie Ihren Fork mit dem ursprünglichen Projekt synchron.
• Pull Request: Schlagen Sie Ihre Änderungen für das ursprüngliche Projekt vor.

Für die Zusammenarbeit an Open-Source-Projekten ist es entscheidend zu verstehen, warum und wie ein Forking-Workflow verwendet wird.

In dieser Lektion haben Sie den Forking-Workflow von GitHub kennengelernt. Sie wissen nun, dass durch Forking eine persönliche Kopie eines Repositorys erstellt wird, sodass Sie auch ohne direkten Schreibzugriff zu Projekten beitragen können.

Sie haben gelernt, wie Sie forken, klonen, Änderungen vornehmen, in Ihren Fork pushen, mit dem Upstream-Repository synchronisieren und schließlich einen Pull Request erstellen, um Ihre Beiträge vorzuschlagen. Dieser Workflow ist ein Grundpfeiler der kollaborativen Entwicklung auf GitHub!