Ga naar hoofdinhoud

IT Essentials Portfolio

Tijdens dit opleidingsonderdeel werk je stap voor stap aan een persoonlijke GitHub-repository: je IT Essentials Portfolio. In die repo bewaar je alle labo-oefeningen van het semester, georganiseerd per blok, bijgehouden via Git.

Dit is geen extra werk bovenop de lessen. Het is de manier waarop je je labo-resultaten inlevert. Elke les commit je wat je gemaakt hebt. Aan het einde van elk blok merge je je werk naar de hoofdbranch via een pull request.

Het doel is tweeledig: je leert Git door het echt te gebruiken, en je bouwt een overzichtelijke historiek op van alles wat je gemaakt hebt dit semester.

Repository-structuur​

Maak je repository aan met de volgende mappenstructuur. Je hoeft niet alles meteen aan te maken, breid uit naarmate het semester vordert.

it-essentials-portfolio/
├── .gitignore
├── README.md
├── git/
│   ├── les1/
│   └── les2/
├── networking/
│   ├── les4/
│   ├── les5/
│   ├── les6/
│   └── les7/
└── linux/
    ├── les8/
    ├── les9/
    ├── les10/
    ├── les11/
    └── les12/

Elke map per les bevat de bestanden die je tijdens die les aangemaakt of aangepast hebt.

Branches​

Je werkt met één branch per blok. Maak de branch aan voor de eerste les van dat blok.

BlokBranch
Gitblok/git
Networkingblok/networking
Linuxblok/linux
# Voorbeeld: branch aanmaken voor het Git-blok
git checkout -b blok/git

Aan het einde van elk blok merge je je branch naar main via een pull request op GitHub. Hoe je dat doet staat uitgelegd in de sectie Pull requests hieronder.

Commits​

Na elke labo-sessie commit je je werk. Een commit is een momentopname van wat je gedaan hebt, zorg dat die boodschap ook echt iets zegt.

Regels voor commit messages​

  • Schrijf in het Nederlands of het Engels, maar kies één taal en hou die aan.
  • De boodschap beschrijft wat je gedaan hebt en eventueel waarom.
  • Vermijd vage boodschappen zoals update, oefening, les 3 of fix.

Voorbeelden​

# ✅ Goede commit messages
git commit -m "Voeg labo-oefening merge conflict toe voor feature/login branch"
git commit -m "Herstel fout in .gitignore: node_modules werd toch getrackt"
git commit -m "Maak mappenstructuur aan voor networking-blok"
git commit -m "Voeg bash script toe dat bestanden sorteert op extensie"
git commit -m "Pas rechten aan op deploy-script: chmod 755"

# ❌ Slechte commit messages
git commit -m "update"
git commit -m "oefening"
git commit -m "les 3"
git commit -m "fix"
git commit -m "asdfgh"

Commit frequentie​

Commit minstens één keer per les. Wacht niet tot het einde van het blok om alles in één keer te pushen, de commit-historiek is een belangrijk onderdeel van de evaluatie.

.gitignore​

Elke repository heeft een .gitignore-bestand in de root. Daarin zet je bestanden en mappen die Git niet mag bijhouden.

Wat hoort er typisch in?

  • Tijdelijke bestanden van je editor (bv. .DS_Store op macOS, Thumbs.db op Windows)
  • Gegenereerde bestanden die je opnieuw kunt aanmaken (bv. archieven die je als oefening aanmaakt en daarna niet meer nodig hebt)
  • Eventuele logbestanden
# Voorbeeld .gitignore
.DS_Store
Thumbs.db
*.log
*.tmp

Een .gitignore aanpassen nadat je al per ongeluk bestanden getrackt hebt? Dan moet je ze eerst uit de index verwijderen:

git rm --cached bestandsnaam

Pull requests​

Aan het einde van elk blok maak je een pull request aan op GitHub om je blok-branch te mergen naar main.

Stap voor stap​

  1. Ga naar je repository op GitHub.
  2. Klik op "Compare & pull request" (verschijnt automatisch als je een branch gepusht hebt), of ga naar Pull requests → New pull request.
  3. Stel in: base: main ← compare: blok/git (of het juiste blok).
  4. Schrijf een beschrijving in het tekstvak (zie hieronder).
  5. Klik op "Create pull request".
  6. Merge de PR nadien zelf via "Merge pull request".

Wat schrijf je in de PR-beschrijving?​

Beantwoord kort deze drie vragen:

  • Wat heb je geleerd in dit blok?
  • Wat vond je moeilijk?
  • Welke oefening vond je het meest nuttig of interessant?

Een paar zinnen per vraag zijn voldoende. Dit is geen formeel verslag, schrijf zoals je zou praten.

Voorbeeld:

In dit blok heb ik geleerd hoe je branches aanmaakt en merge conflicts oplost. Het lastigste vond ik de situatie waarbij twee branches dezelfde regel hadden aangepast, ik begreep eerst niet wat Git van me verwachtte. De oefening waarbij we een conflict bewust uitlokten en dan oplossen vond ik het meest nuttig, omdat ik daarna veel beter snapte wat er achter de schermen gebeurt.

Evaluatiecriteria​

Je wordt beoordeeld op basis van je GitHub-repository. We kijken naar het volgende:

CriteriumOmschrijving
BranchstructuurZijn de drie blok-branches aangemaakt en gemerged via een PR?
Commit frequentieIs er minstens één commit per les? Geen dump van alles op het einde.
Commit kwaliteitZijn de commit messages beschrijvend? We bekijken een steekproef.
.gitignoreAanwezig en zinvol geconfigureerd.
PR-beschrijvingBevat een korte reflectie per blok (zie sectie hierboven).

Inleveren​

Je maakt je repository aan via GitHub Classroom. De uitnodigingslink vind je op Digitap.

Wanneer je op de link klikt, wordt er automatisch een persoonlijke repository voor je aangemaakt in GitHub Classroom. Werk verder in die repository, niet in een zelfgemaakte repo.

De lector heeft zo automatisch toegang tot alle repositories en kan je voortgang opvolgen. Verdere commits en pull requests voeg je doorheen het semester toe.

Samenvatting: checklist per les​

Gebruik dit als geheugensteuntje na elke les:

  • Labo-bestanden opgeslagen in de juiste map (blok/les_nr/)
  • Bestanden toegevoegd met git add
  • Gecommit met een beschrijvende boodschap
  • Gepusht naar GitHub (git push)

En aan het einde van elk blok:

  • Pull request aangemaakt van blok/... naar main
  • PR-beschrijving ingevuld (3 vragen)
  • PR gemerged