De eerste keer dat je iets nieuws probeert is altijd lastig, helemaal wanneer je samen werkt - kan het maken van fouten erg vervelend zijn. Maar in open-source ontkom je niet aan samenwerken. We willen het graag makkelijker maken om te leren en bij te dragen voor de eerste keer aan een open-source project.
Het kan helpen om de artikelen te lezen en de video's te bekijken, maar niets is beter dan het gelijk te doen terwijl je leert en je niet de kans hebt om een fout te maken. Dit project richt zich op het begeleiden en het makkelijker maken voor beginners om hun eerste bijdrage te leveren aan een project. Onthoud: Hoe meer ontspannen je bent hoe beter je leert. Indien je op zoek bent om je eerste bijdrage te leveren aan open-source volg dan de onderstaande stappen. Wij beloven dat je het leuk zal vinden xxxx.
Indien je git nog niet hebt op je systeem, installeer het dan eerst
Fork deze repository door op de fork knop te klikken. Dit creëert een kopie van deze repository in jouw account.
Kloon nu deze repository naar je systeem. Klik op de kloon knop en dan op het kopiëren naar klembord icoon.
Open een terminal en voer het volgende git commando uit:
git clone "Gekopieerde repository"
Waar "Gekopieerde repository" (zonder aanhalingstekens) de url naar (jouw fork van) deze repository is. Zie de vorige stappen om de url te vinden.
Bijvoorbeeld:
git clone https://github.com/this-is-you/first-contributions.git
Waar 'this-is-you' staat vul jij je GitHub gebruikersnaam is. Hiermee kopieer je de inhoud van de first-contributions repo op GitHub naar je systeem.
Navigeer naar de map van de repository op je systeem (mocht je daar niet al zijn).
cd first-contributions
Maak nu een branch aan door middel van het git checkout command
git checkout -b <je-nieuwe-branch-naam>
Bijvoorbeeld:
git checkout -b add-thibmaek
(De naam van de branch hoeft niet het woord add te bevatten. In dit voorbeeld is het wel te adviseren aangezien het doel van deze branch hiermee duidelijk wordt gemaakt.)
Open nu het Contributors.md bestand in een teksteditor en voeg je naam toe. Doe dit niet aan het begin of eind, maar ergens in het midden. Sla vervolgens het bestand op.
Als je naar de projectmap gaat en git status doet, zul je zien dat er wijzigingen zijn. Voeg deze toe aan je branch met behulp van onderstaand git add commando.
git add Contributors.md
Commit nu deze wijzigingen door onderstaand git commit commando te gebruiken.
git commit -m "Add <jouw-naam> to Contributors list"
vervang <jouw-naam> met jouw naam
Push je wijzigingen met git push
git push origin <je-nieuwe-branch-naam>
Vervang <je-nieuwe-branch-naam> met de naam van de branch die je eerder aanmaakte.
Als je naar je repository gaat op GitHub, zal je zien dat er een Compare & pull request knop staat. Klik hierop.
Verstuur nu je pull request.
Nu ga ik (de beheerder) al je wijzigingen mergen in de master branch van dit project. Als de veranderingen gemerged zijn, zul je hier een e-mailnotificatie over ontvangen.
Wanneer de pull request wordt geaccepteerd en gemerged, zal jouw fork de wijzigingen nog niet bevatten - hiervoor moet je nog een aantal extra stappen ondernemen.
Om beide repo's met elkaar in sync te houden voeg je de hoofd repo (mijne) url in als upstream remote url.
git remote add upstream https://github.com/firstcontributions/first-contributions
Hiermee vertel je git dat er nog een andere versie van dit project bestaat op dit specifieke url punt en dat we het upstream zullen noemen. Wanneer de wijzigingen gemerged zijn, kun je de nieuwe versie ophalen (fetchen) van mijn repo.
git fetch upstream
Hiermee fetchen we alle wijzigingen in mijn fork (upstream remote). Nu zal je de nieuwe revisie/versie van mijn repo moeten mergen in jouw master branch.
git rebase upstream/master
Dit voegt alle wijzigingen toe die je net fetchte van de master branch. Als je nu probeert je master branch te pushen, zal je fork al deze wijzigingen ook bevatten.
git push origin master
Merk op dat je in dit geval pusht naar de remote met de naam origin.
 |
 |
 |
|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken |
Gefeliciteerd! Je hebt zojuist de standaard fork -> clone -> edit -> PR workflow doorlopen die je vaak zult tegenkomen als bijdrager!
Vier je bijdrage en deel het met je vrienden en volgers via de web app.
Mocht je nog vragen of hulp nodig hebben dan kun je je aanmelden voor ons Slack team.
Laten we je nu op weg helpen met het bijdragen aan andere projecten. We hebben een lijst samengesteld met projecten die makkelijke issues bevatten waar je aan kunt werken. Bekijk de lijst op de web app
Hier zijn enkele beginner-level issues in populaire repos die je kan proberen oplossen. Ga verder naar deze repos om meer te lezen.
