README.nl.md

Eerste bijdragen

Dit project heeft als doel het versimpelen en het begeleiden van beginners in het maken van hun eerste bijdragen. Als je op het punt staat om je eerste bijdragen te maken, volg dan onderstaande stappen.

Als je je niet comfortable voelt met de command line, vind je hier handleidingen voor het gebruik van GUI tools.

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 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 url"

Waar "Gekopieerde repository url" (zonder aanhalingstekens) de url naar (jouw fork van) deze repository is. Zie de vorige stappen om de url te vinden.

Bijvoorbeeld:

git clone git@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 switch commando:

git switch -c je-nieuwe-branch-naam

Bijvoorbeeld:

git switch -c add-alonzo-church

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 -u origin je-nieuwe-branch-naam

Vervang je-nieuwe-branch-naam met de naam van de branch die je eerder hebt aangemaakt.

Als je foutmeldingen krijgt tijdens het pushen, klik dan hier:

• Authentication Error

  remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
  remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
  fatal: Authentication failed for 'https://github.com//first-contributions.git/'

  Ga naar GitHub's tutorial voor het genereren en configureren van een SSH-sleutel in je account.

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.

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.

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

Handleidingen voor andere tools

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree	IntelliJ IDEA

Dit project is gesponsord door: