Forkworkflows op GitHub

Stel dat je wilt bijdragen aan een opensourceproject, maar geen toestemming hebt om de code rechtstreeks te wijzigen. Dan komt forken van pas!

Een fork is eenvoudigweg een persoonlijke kopie van de GitHub-repository van iemand anders. Deze staat onder je eigen GitHub-account, waardoor je volledige controle hebt om te experimenteren en wijzigingen aan te brengen zonder het oorspronkelijke project te beïnvloeden.

De belangrijkste reden om een repository te forken is om wijzigingen voor te stellen aan een project wanneer je geen directe schrijftoegang tot de oorspronkelijke codebase hebt.

• Veilig experimenteren: Werk in je eigen kopie zonder bang te hoeven zijn dat je het origineel beschadigt.
• Bijdragen aan projecten: Dit is de gebruikelijke manier om functies of oplossingen voor openbare projecten voor te stellen.
• Persoonlijke projecten: Gebruik een fork als startpunt voor je eigen verwante project.

Een repository op GitHub forken is heel eenvoudig:

1. Ga naar de oorspronkelijke repository die je wilt forken.
2. Zoek de knop 'Fork', meestal in de rechterbovenhoek.
3. Klik op de knop 'Fork'. GitHub maakt vervolgens een kopie van die repository onder je account.

Je hebt nu github.com/YOUR_USERNAME/ORIGINAL_REPO_NAME.

Nadat je de repository op GitHub hebt geforkt, wil je die kopie naar je lokale machine halen om eraan te gaan werken.

Gebruik de opdracht git clone, maar zorg ervoor dat je de URL van je fork kloont en niet de URL van de oorspronkelijke repository.

Nu je je fork lokaal hebt gekloond, kun je wijzigingen maken zoals in elk ander Git-project. Het is een goede gewoonte om voor je functie of oplossing een nieuwe branch te maken.

Nadat je je wijzigingen lokaal hebt gecommit, moet je deze naar je externe fork op GitHub pushen. Hiermee werk je je persoonlijke kopie van de repository bij.

De externe repository origin verwijst meestal naar je fork.

Terwijl je aan je fork werkt, kan de oorspronkelijke repository (vaak 'upstream' genoemd) nieuwe updates ontvangen. Om je fork actueel te houden, moet je deze synchroniseren.

Voeg eerst de oorspronkelijke repository toe als een nieuwe externe repository met de naam upstream. Haal daarna de wijzigingen op en voeg ze samen.

Nadat je wijzigingen klaar zijn en naar je fork zijn gepusht, kun je ze terug voorstellen aan het oorspronkelijke project. Dit doe je via een pullrequest (PR).

Ga op GitHub naar je fork. Vaak zie je een banner met de suggestie om vanaf je nieuwe branch een PR te maken. Volg de aanwijzingen om je branch te vergelijken met de main-branch van de oorspronkelijke repository en je voorstel in te dienen.

Dit is de gebruikelijke forkingworkflow in het kort:

• Forken: Maak je persoonlijke kopie op GitHub.
• Klonen: Haal je fork naar je lokale machine.
• Ontwikkelen: Maak wijzigingen in een nieuwe branch.
• Pushen: Stuur je wijzigingen naar je externe fork.
• Synchroniseren: Houd je fork bijgewerkt met het oorspronkelijke project.
• Pullrequest: Stel je wijzigingen voor aan het oorspronkelijke project.

In deze les heb je de GitHub-forkingworkflow geleerd. Je begrijpt nu dat forken een persoonlijke kopie van een repository maakt, zodat je aan projecten kunt bijdragen, zelfs zonder directe schrijftoegang.

We hebben behandeld hoe je een fork maakt, kloont, wijzigingen aanbrengt, naar je fork pusht, synchroniseert met de upstream-repository en ten slotte een pullrequest maakt om je bijdragen voor te stellen. Deze workflow vormt een hoeksteen van gezamenlijk ontwikkelen op GitHub!