Skip to content

Latest commit

 

History

History
162 lines (100 loc) · 19.4 KB

README.nl.md

File metadata and controls

162 lines (100 loc) · 19.4 KB

Open Source Love License: MIT Open Source Helpers

Eerste bijdragen

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.

fork deze repository

Indien je git nog niet hebt op je systeem, installeer het dan eerst

Deze repository forken

Fork deze repository door op de fork knop te klikken. Dit creëert een kopie van deze repository in jouw account.

De repository clonen

kloon deze repository

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.

kopieer URL naar het klembord

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.

Een branch aanmaken

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.)

Maak de benodigde wijzigingen en commit deze

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 de wijzigingen naar GitHub

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.

Verstuur je wijzigingen voor review

Als je naar je repository gaat op GitHub, zal je zien dat er een Compare & pull request knop staat. Klik hierop.

creëer een pull request

Verstuur nu je pull request.

verstuur 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.

Je fork in sync houden met de hoofd-repository

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.

Tutorials gebruiken Andere hulpmiddelen

GitHub Desktop Visual Studio 2017 GitKraken
GitHub Desktop Visual Studio 2017 GitKraken

Hoe nu verder?

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.

exercism fun-retro habitat scikit-learn elasticsearch
exercism Fun Retros react habitat scikit-learn Leiningen numpy elasticsearch
homebrew rust vuejs Suave OpenRA PowerShell coala moment
homebrew Rust vuejs Suave OpenRA PowerShell coala moment
ava freeCodeCamp webpack hoodie pouchdb neovim babel
ava freeCodeCamp webpack hoodie pouchdb neovim babel brackets
Node.js
Node.js Semantic-UI-React