Appendix

Cheat sheet voor basic workflow

#

# Aanmaken van lokale start repo
# _README.md_ en _.gitignore_ bestand aanmaken
git init
git add .
git commit -m "startbestanden"

# Pushen van lokale start repo naar remote repo
# remote repo aanmaken op GitHub*
git remote add origin https://github.com/...
git push -u origin main

# Clonen van remote repo
# Bash openen in gewenste folder
git clone https://github.com/...

# Gewijzigde bestanden stagen en committen

git add <file(s)>
git commit -m "comment"

# Lokale commits uploaden naar remote repo
git push

#Verschillen weergeven tussen versie in lokale repo en versie in working tree
git diff of git diff <file>

# Verschillen weergeven tussen versie in lokale repo en versie in staging area
git diff --staged*
# of
git diff --staged <file>

# Status (van working tree en staging area) weergeven
git status

Teamwork workflow

#

Je hebt nu al geleerd hoe je GitHub en Git kunt gebruiken om versiebeheer op je projecten te doen. In deze tutorial gaan we een stap verder en gebruiken we Git om in teamverband aan dezelfde codebase te werken.

Werken met “branches”

#

Nadat je het project hebt gecloned op je computer kunnen we beginnen te werken aan code veranderingen. We doen dit in branches. Branches, ook wel feature branches genoemd, maken een kopie van de hoofdcode die zich op de “main” branch bevindt. Het is een slechte gewoonte om direct naar de “main” branch te pushen als je in teams werkt. Een uitzondering op deze regel is de eerste commit.

In een branch kun je zoals gebruikelijk één of meer commits maken, deze geven de wijzigingen weer om een bepaald deel van de code toe te voegen. Om een nieuwe branch te maken kun je het volgende doen met Git

$ git branch <branch naam>

De branchnaam moet het deel bevatten dat je van plan bent toe te voegen, en ook meestal je naam, zodat je geen conflicten met je teamgenoten hebt. Een naam zou bijvoorbeeld jefke-add-contact-page kunnen zijn, merk op dat branchnamen geen spaties mogen bevatten!

Takken maken doe je met git branch. Na het aanmaken van de branch moet je overschakelen naar het gebruik van die branch. Dit kan gedaan worden met git checkout.

$ git checkout [branch naam]

Dit commando zal de bestanden op je harde schijf aanpassen aan de bestanden in de branch. Het is dus normaal dat je nieuwere bestanden nog niet ziet. Het maakt een eigen kopie zodat je tijdens je werk niet “gestoord” wordt door wijzwgingen op de main branch.

Je kunt nu zoals gewoonlijk werken en git add en git commit gebruiken om je wijzigingen vast te leggen. Je kunt git push gebruiken als je op een branch zit om de branch naar GitHub te pushen

Een volledige workflow zou bijvoorbeeld zijn

git branch add-contact-page
git checkout add-contact-page

touch contact.html # voorbeeld verandering!!! geen onderdeel van de workflow

git add .
git commit -m "Een contactpagina gemaakt"
git push --set-upstream origin maartje-add-contact-page # eerste keer nodig, gebruik gewoon git push` voor latere wijzigingen in de branch

Pull Requests

#

Pull requests, ook wel Merge Requests genoemd in andere Git oplossingen, zijn verzoeken die gedaan worden om code van een bepaalde branch samen te voegen in de “main” branch van het repository. Je kunt dit doen nadat je voor de eerste keer “git push” gedaan hebt, door naar de repository op Github te gaan en naar “Pull Requests” te gaan, hier kun je klikken op “New Pull Request”.