# V1 Feedback & Reflectie

Dit document bevat de reflectie op de eerste versie van het curriculum, gebaseerd op de ervaringen tijdens het geven van les 1 en les 2 aan de eerste groep studenten (februari 2026).

---

## Les 1: Introductie tot AI en Large Language Models

### Wat ging goed
- ChatGPT gedeelte verliep soepel
- Iedereen kon meedoen en de uitleg volgen
- Studenten waren enthousiast over de workflow

### Wat ging minder
- Docent versprak zich regelmatig en ging "van de hak op de tak"
- Mogelijk oorzaken: verkeerde slide-volgorde of zenuwen/onwetendheid bij eerste les

### Probleempunt: Account setup chaos
Bij het aanmaken van v0.dev account, koppelen met GitHub, en deployen naar Vercel werd het rommelig:
- Studenten gingen door elkaar praten
- Veel verschillende issues tegelijkertijd:
  - Sommigen konden GitHub niet koppelen
  - Anderen hadden eerst gedeployed en daarna pas gekoppeld
  - Ontelbare onduidelijkheden

### Aanbevolen verbeteringen v2
1. **Strakker stappenplan:** Iedereen doet elke stap samen, wachten tot iedereen klaar is
2. **Checkpoints toevoegen:** "Steek je hand op als je dit scherm ziet"
3. **Troubleshooting slide:** Meest voorkomende problemen + oplossingen
4. **Volgorde slides herzien:** Logischer opbouwen

---

## Les 2: AI Code Assistants en OpenCode

### Wat ging goed
- Zodra OpenCode draaide, konden studenten goed meekomen
- Lokaal draaien van website lukte uiteindelijk
- Studenten slaagden erin om `/init` te gebruiken en nieuwe pagina's te maken
- Wireframe → prompt → componenten werkte goed

### Probleem 1: Te vroeg installeren
Zodra studenten de install command en "Download Desktop App" zagen op de slides, begonnen ze direct te installeren. Dit werd chaotisch terwijl de docent nog aan het uitleggen was.

**Oplossing v2:**
- Installatie-instructies pas tonen NA de conceptuele uitleg
- Of expliciet vermelden: "WACHT - nog niet installeren, eerst kijken"

### Probleem 2: Terminal en permissies
Veel studenten hadden problemen met hun terminal:
- **Windows vs Mac:** Verschillende omgevingen, verschillende commands
- **EACCESS errors:** Geen rechten om globaal te installeren
- **Sudo vereist:** Sommigen moesten met sudo installeren

**Oplossing v2:**
- Voorbereiding document met terminal setup
- Aparte instructies voor Windows en Mac
- Uitleg over permissies en sudo

### Probleem 3: Git clone en SSH keys
Bij het clonen van hun GitHub repository:
- Veel studenten hadden geen SSH key geconfigureerd
- Sommigen konden wel met HTTPS clonen (maar dat is minder ideaal)

**Oplossing v2:**
- SSH key setup als voorbereiding VOOR de les
- Of HTTPS als fallback accepteren voor beginners
- Duidelijke instructies in voorbereidingsdocument

### Probleem 4: Node.js versie
Bij npm install:
- Sommige studenten hadden verkeerde Node versie
- Geen ervaring met versie management

**Oplossing v2:**
- NVM (Node Version Manager) introduceren
- Specifieke Node versie vereisen (bijv. Node 20 LTS)
- Check command in voorbereiding: `node -v`

### Probleem 5: OpenCode terminal vs System terminal
Studenten runden commands in de OpenCode terminal terwijl ze het in hun system terminal moesten doen:
- Begrepen niet dat ze eerst `exit` moesten doen bij OpenCode
- Verwarring over welke terminal voor wat

**Oplossing v2:**
- Duidelijker onderscheid maken tussen terminals
- Visueel verschil tonen (screenshots)
- Expliciete instructie: "Dit doe je in je EIGEN terminal, NIET in OpenCode"

### Probleem 6: Tokens op bij gratis modellen
De tokens van gratis modellen raakten vrij snel op:
- "Arme studenten" - alleen gratis modellen beschikbaar
- Beperkt aantal prompts mogelijk per les

**Oplossing v2:**
- Studenten aanmoedigen om prompts efficiënt te formuleren
- Meerdere gratis modellen tonen (backup opties)
- Eventueel: docent-account met meer tokens voor demo's

---

## Algemene verbeteringen voor v2

### 1. Voorbereidingsdocument toevoegen
Een "Les 0" of voorbereidingsdocument dat studenten VOOR de eerste les moeten doorlopen:
- [ ] Node.js installeren (via NVM)
- [ ] Git installeren
- [ ] SSH key genereren en toevoegen aan GitHub
- [ ] Terminal basics (cd, ls, pwd)
- [ ] GitHub account aanmaken

### 2. Platform-specifieke instructies
- Aparte secties voor Windows en Mac
- Screenshots van beide omgevingen
- Bekende issues per platform

### 3. "Volg mij" aanpak
- Kleinere stappen
- Wachten tot iedereen klaar is
- Checkpoints met handopsteking of poll

### 4. Troubleshooting secties
- Veelvoorkomende errors met oplossingen
- QR code naar online troubleshooting guide?

### 5. Slide volgorde herzien
- Conceptuele uitleg VOOR praktische stappen
- "Nog niet doen" waarschuwingen waar nodig

---

## Les 3: Cursor Basics

### Context
Oorspronkelijk zou les 3 gaan over privacy en security van AI. Tim heeft besloten om in plaats daarvan een les over Cursor te geven — een praktischere les die beter aansluit bij wat studenten nodig hebben. Dit was een goede keuze.

### Wat ging goed
- Studenten waren enthousiast over Cursor
- De les liep goed: de structuur met stappen (git init → Cursor → npx create-next-app → Skills/Docs → .cursorrules → componenten bouwen) werkte
- Huiswerk uitgedeeld: Debug Challenge in drie niveaus (standaard, hard, super hard) — studenten konden zelf hun niveau kiezen
- De "hands-on" aanpak (75 minuten bouwen na de pauze) was effectief

### Wat zou anders kunnen in v2
- Les was aangepast t.o.v. het originele curriculum (privacy/security → Cursor). In v2 moet het curriculum dit vanaf het begin reflecteren
- Eventueel privacy/security integreren in een andere les, of als korte module ergens toevoegen

---

## Les 4: TypeScript Fundamentals

### Context
Les over TypeScript basics met een Escaperoom opdracht.

### Wat ging goed
- TypeScript Escaperoom was effectief als lesvorm
- Studenten begrepen het concept van type safety
- Cursor hielp studenten bij het oplossen van type errors

### Wat zou anders kunnen in v2
- Les 4 was goed maar v2 moet de collaborative format meenemen
- Meer live coding demonstraties

---

## Les 5: Next.js — Het React Framework

### Context
Oorspronkelijk was dit "TypeScript voor React" maar Tim sprong direct naar Next.js. De les behandelde Next.js basics inclusief App Router, Components, Data Fetching, en de start van Server Actions.

### Wat ging goed
- Next.js content was relevant en studenten waren gemotiveerd
- QuickPoll project was een leuke, concrete opdracht
- Starter zip met scaffolded files was goed ontvangen

### Wat ging minder
- Theorie was te lang: ~1 uur gepraat maar stopte bij Server Actions (slide 17 van 32), slides 18-32 niet behandeld
- Hands-on opdracht was te moeilijk voor zelfstandig werk: in 1.5 uur kwamen de meeste studenten tot stap 2-3 (van 7 stappen)
- Format "1 uur college + 2 uur solo" werkt niet goed

### Studentfeedback
- Studenten gaven aan dat ze liever SAMEN willen bouwen
- Meer houvast en meer sparren gewenst
- Klassikaal werken heeft voorkeur boven individueel

### Aanbevolen verbeteringen v2
1. Les splitsen over 2 lessen (Les 5 = Part 1, Les 6 = Part 2)
2. Theorie inkorten tot ~45 min (stop bij Server Actions)
3. Hands-on klassikaal doen: Tim codeert voor, studenten volgen mee
4. Overige theorie (API Routes, Middleware, Deployment, Cursor) naar Les 6
5. Stap 0-3 in Les 5, Stap 4-7 in Les 6

---

## Conclusie

De kern van de lessen (AI concepten, prompting, development workflow) werkt goed. De problemen zitten vooral in:

1. **Voorbereiding:** Studenten komen onvoorbereid qua development setup
2. **Tempo:** Te snel door setup-stappen heen
3. **Platform diversiteit:** Windows/Mac verschillen onderschat
4. **Terminal ervaring:** Veel studenten hebben weinig terminal ervaring
5. **Lesformat na Les 5:** Studentfeedback laat duidelijk zien dat klassikaal/collaborative werken effectiever is dan zelfstandig werken

### Les 4-5 inzichten
Les 4 (TypeScript Escaperoom) werkte goed en moet in v2 behouden blijven. Les 5 heeft echter grote verbeteringen nodig:
- De combinatie van lange theorieblok + korte hands-on time werkt niet
- Studenten prefereren klassikaal leren en samen bouwen
- Content moet gesplitst worden over meerdere lessen met meer praktische focus
- Het format voor alle toekomstige lessen moet aangepast worden naar collaborative/klassikaal werken

V2 moet focussen op betere voorbereiding, duidelijkere stapsgewijze instructies met checkpoints, en vooral: het overschakelen naar klassikaal/collaborative lesformat voor alle lessen.

---

*Laatste update: maart 2026*
*Gebaseerd op: Les 1, 2, 3, 4 en 5 gegeven aan eerste groep*
