Het is altijd moeilijk de eerste keer dat je iets doet. 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 lezen van artikelen en het bekijken van video's kan helpen, maar wat is beter dan het gelijk 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 de onderstaande stappen. Wij beloven dat je het leuk zal zijn.
Indien je git nog niet hebt op je systeem, installeer het dan eerst
Fork deze repo door op de fork knop te klikken
Kloon nu deze repo naar je systeem. Klik op de kloon knop en dan het kopiëren naar klembord icoon
Open een terminal en voer volgend git commando uit:
git clone "url die je net kopieerde"
Waar "url die je net kopieerde" (zonder aanhalingstekens) de url naar 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' je Github gebruikersnaam is. Hiermee kopieer je inhoud van de first-contributions repo op Github naar je systeem.
Navigeer naar de map van de repository op je systeem als je dit nog niet deed.
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
Open nu het Contributors.md bestand in een teksteditor en voeg je naam toe, sla het bestand vervolgens op. Als je naar de projectmap gaat en git status doet, zal je de wijzigingen zien. Voeg deze toe 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 al je wijzigingen mergen in de master branch van dit project. Jouw fork zal deze wijzigingen niet hebben. 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/multunus/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. Eens de wijzigingen gemerged zijn, fetch je de nieuwe versie 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 to 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 |
Hier zijn enkele beginner-level issues in populaire repos die je kan proberen oplossen. Ga verder naar deze repos om meer te lezen.
