docs(assignments): add beginner-context callouts and skip-friendly leeswijzer

docs/01-argocd-bootstrap.md

@@ -14,6 +14,14 @@
 
 ---
 
+## Leeswijzer
+
+> **Voor beginners (optioneel):**
+> De extra uitlegblokken in deze oefening leggen uit *waarom* je iets doet.
+> Als je al ervaring hebt met ArgoCD/GitOps, kun je die blokken gerust overslaan en alleen de stappen/snippets uitvoeren.
+
+---
+
 ## Vereisten
 
 De VM draait en je bent ingelogd:
@@ -84,6 +92,10 @@ Login: `admin` / het wachtwoord uit de output van het script.
 Het bootstrap-script installeert ArgoCD, maar registreert jouw Git-repo niet in ArgoCD.
 Daarom moet je in deze stap expliciet je repo toevoegen, anders blijft `root` op `Unknown`/`authentication required`.
 
+> **Voor beginners (optioneel):**
+> ArgoCD weet pas *welke* Git-repo het moet lezen als je die repo registreert.
+> Deze stap gaat dus niet alleen over toegang/rechten, maar ook over het "bekend maken" van de repo zelf.
+
 Kies een van deze twee paden:
 
 **Pad A — via ArgoCD UI**

docs/02-deploy-podinfo.md

@@ -14,6 +14,14 @@
 
 ---
 
+## Leeswijzer
+
+> **Voor beginners (optioneel):**
+> In deze oefening doe je bewust geen `kubectl apply` voor podinfo.
+> Dat voelt in het begin onnatuurlijk, maar is precies het GitOps-principe: Git verandert, ArgoCD voert uit.
+
+---
+
 ## Vereisten
 
 Oefening 01 afgerond. ArgoCD draait en de root app is Synced.
@@ -106,6 +114,10 @@ spec:
 
 **`apps/apps/podinfo.yaml`**
 
+> **Voor beginners (optioneel):**
+> Zie deze `Application` als een "pointer":
+> hij zegt tegen ArgoCD *waar* de echte Kubernetes YAML staat (`manifests/apps/podinfo`) en *waar* die toegepast moet worden (namespace `podinfo`).
+
 ```yaml
 apiVersion: argoproj.io/v1alpha1
 kind: Application

docs/03-metallb-ingress.md

@@ -16,6 +16,14 @@ port-forward.
 
 ---
 
+## Leeswijzer
+
+> **Voor beginners (optioneel):**
+> In deze oefening komen netwerkconcepten samen (LoadBalancer IP, Ingress, DNS-hostname).
+> Lees de "Wat dit doet" blokken eerst rustig door; plak pas daarna de YAML.
+
+---
+
 ## Achtergrond
 
 In cloud-Kubernetes (EKS, GKE, AKS) regelt `type: LoadBalancer` automatisch een load balancer met een extern IP. Op bare
@@ -254,6 +262,10 @@ Vanuit je laptop:
 > # 404 van Nginx — klopt, nog geen Ingress-regel
 > ```
 
+> **Voor beginners (optioneel):**
+> Deze `404` is hier juist positief:
+> je bereikt de ingress-controller wel, maar er is nog geen Ingress-regel voor jouw app.
+
 ---
 
 ### 4. Ingress voor podinfo toevoegen

docs/04-tekton-pipeline.md

@@ -14,6 +14,15 @@ volledige GitOps CI/CD-loop.
 
 ---
 
+## Leeswijzer
+
+> **Voor beginners (optioneel):**
+> Oefening 04 heeft de meeste moving parts.
+> Alle alinea's met "Waarom dit" kun je zien als mini-achtergrond.
+> Gevorderden kunnen die overslaan en direct de snippets volgen.
+
+---
+
 ## De loop
 
 ```

docs/05-app-upgrade.md

@@ -50,6 +50,15 @@ Tekton PipelineRun
 
 ---
 
+## Leeswijzer
+
+> **Voor beginners (optioneel):**
+> Zie oefening 05 als "begrijpen wat je net gebouwd hebt".
+> Het doel is minder nieuwe YAML, en meer leren herkennen van gedrag:
+> wie doet wat (Tekton commit, Argo sync, Kubernetes rollout).
+
+---
+
 ## Probeer het: handmatige downgrade
 
 Als de pipeline podinfo al naar `6.7.0` heeft gebracht, probeer dan een handmatige downgrade:

docs/06-monitoring.md

@@ -14,6 +14,15 @@
 
 ---
 
+## Leeswijzer
+
+> **Voor beginners (optioneel):**
+> Deze bonusoefening is vooral "leren observeren".
+> Focus eerst op: stack komt up, Grafana opent, dashboards tonen data.
+> Daarna pas op fine-tuning van values.
+
+---
+
 ## Vereisten
 
 Oefeningen 01–03 afgerond. Ingress-Nginx draait en nip.io-URLs zijn bereikbaar vanaf je laptop.
@@ -119,6 +128,10 @@ spec:
 
 De initiële sync duurt 5–8 minuten — de chart is groot en installeert veel CRDs.
 
+> **Voor beginners (optioneel):**
+> Dit duurt merkbaar langer dan eerdere oefeningen en dat is normaal.
+> Je installeert hier geen losse app, maar een complete monitoring-stack met veel onderdelen.
+
 ---
 
 ### 2. Wachten tot de stack klaar is