Code Netjes Maken

Leerlingen onthouden alleen wat ze actief toepassen. Door code direct te bewerken, namen te herzien en commentaar te schrijven, ervaren ze zelf hoe structuur de samenwerking vergemakkelijkt. Deze hands-on aanpak maakt abstracte concepten als leesbaarheid tastbaar en verankert ze in hun eigen werk.

• Klas 6 VWO
• Informatica Meesterschap: Van Algoritme tot Maatschappij
• 4 activiteiten
• 25 min–45 min

Leerdoelen

1. Demonstreer het belang van leesbare code door twee codefragmenten met dezelfde functionaliteit, maar verschillende leesbaarheid, te vergelijken.
2. Creëer commentaar in een gegeven codefragment om de logica van de implementatie te verduidelijken.
3. Analyseer een codefragment en identificeer variabelen en functies die onduidelijke namen hebben, en stel verbeterde namen voor.
4. Evalueer de leesbaarheid van codefragmenten geschreven door medeleerlingen en geef constructieve feedback op naamgeving en commentaar.

⏱ 30 min·Duo's

Peer Review: Code Nakijken

Deel leerlingen in paren in en laat ze elkaars code printen of op scherm delen. Ze controleren op commentaar en variabelenamen, geven feedback met een rubric. Herzien de code op basis van suggesties.

Voorbereiding & details

Waarom is het belangrijk dat je code makkelijk te lezen is voor anderen (en voor jezelf later)?

Facilitatietip: Geef tijdens de Peer Review heldere beoordelingscriteria mee, zoals een checklist met 3 punten voor namen en 2 voor commentaar.

⏱ 45 min·Kleine groepjes

Refactoring Uitdaging: Rommelige Code Opruimen

Geef groepen een rommelige codevoorbeeld met vage namen en geen commentaar. Ze herschrijven het stap voor stap: eerst namen verbeteren, dan commentaar toevoegen, en testen of het werkt.

Voorbereiding & details

Hoe kun je uitleg toevoegen aan je code?

Facilitatietip: Laat bij de Refactoring Uitdaging leerlingen eerst een versie maken die werkt, voordat ze nadenken over netheid. Zo voorkom je dat ze clean code verwarren met perfecte code.

⏱ 25 min·Kleine groepjes

Naamgeving Toernooi: Beste Namen Kiezen

Presenteer een lijst variabelen met voorbeelden. In kleine groepen stemmen ze op beste namen en rechtvaardigen keuzes. Winnaar presenteert aan de klas met redenen.

Voorbereiding & details

Wat zijn goede namen voor variabelen en functies?

Facilitatietip: Organiseer het Naamgeving Toernooi als een stille brainstorm: leerlingen schrijven namen op kaartjes, leggen ze naast elkaar en stemmen anoniem op de beste optie.

⏱ 35 min·Duo's

Commentaar Workshop: Stap-voor-Stap Uitleg

Laat individuen een eigen algoritme coderen, dan commentaar toevoegen. Wissel met een partner voor feedback, pas aan en deel finale versie.

Voorbereiding & details

Waarom is het belangrijk dat je code makkelijk te lezen is voor anderen (en voor jezelf later)?

Facilitatietip: Geef bij de Commentaar Workshop eerst een voorbeeld van te veel commentaar (herhalen wat de code al doet) en te weinig (alleen een titel).

Dit onderwerp onderwijzen

Begin met kleine, herkenbare voorbeelden waar de code nog werkt maar onduidelijk is. Laat leerlingen ervaren hoe lang ze erover doen om de logica te doorgronden, en vergelijk dit met een versie met betere namen en commentaar. Vermijd technisch jargon; focus op praktische voordelen zoals tijdwinst bij aanpassingen. Onderzoek toont aan dat leerlingen pas waarderen hoe belangrijk netheid is als ze zelf de frustratie ervaren van slecht onderhoudbare code.

Wat je kunt verwachten

Succesvolle leerlingen kunnen in eigen code drie concrete verbeteringen aanbrengen: beschrijvende namen, helder commentaar en logische opbouw. Ze herkennen ook in andermans code welke elementen de leesbaarheid belemmeren en geven gerichte feedback.

Pas op voor deze misvattingen

Veelvoorkomende misvatting

Tijdens de Peer Review denken leerlingen dat commentaar alleen voor beginners is.

Wat je in plaats daarvan kunt onderwijzen

Geef ze tijdens de Peer Review een codefragment met moeilijke logica die zonder commentaar niet te volgen is. Laat ze ervaren hoe commentaar de tijd om fouten te vinden verkort.

Veelvoorkomende misvatting

Tijdens het Naamgeving Toernooi kiezen leerlingen korte namen zoals 'i' of 'x' omdat dat sneller werkt.

Wat je in plaats daarvan kunt onderwijzen

Laat leerlingen in groepjes een fragment herschrijven met de slechte namen, en meet hoe lang ze erover doen om de code te begrijpen. Vergelijk dit met een versie met duidelijke namen.

Veelvoorkomende misvatting

Tijdens de Refactoring Uitdaging vinden leerlingen dat onderhoud pas later relevant is.

Wat je in plaats daarvan kunt onderwijzen

Geef ze een fragment met een bug die alleen gevonden kan worden door de logica goed te begrijpen. Laat ze zien hoe slechte namen de debugging vertragen.

Toetsideeën

Peerbeoordeling

Na de Peer Review wisselen leerlingen elkaars code en feedback uit. Beoordeel of de gegeven suggesties concreet zijn: bij namen moet een specifieke variabele of functie genoemd worden en bij commentaar moet een regel of logische stap aangeduid worden.

Uitgangskaart

Tijdens de Commentaar Workshop vraag je leerlingen om een onduidelijk fragment te analyseren. Ze schrijven drie betere namen en voegen één regel commentaar toe. Beoordeel of de namen de functie duidelijk maken en of het commentaar een cruciale stap uitlegt.

Snelle Controle

Tijdens de Refactoring Uitdaging toon je een fragment op het bord met slechte namen en zonder commentaar. Leerlingen noteren in tweetallen de drie meest storende elementen en bedenken hoe ze dit zouden verbeteren. Bespreek klassikaal welke elementen de leesbaarheid het meest belemmeren.

Uitbreidingen & ondersteuning

• Laat leerlingen een codefragment uit de Refactoring Uitdaging uitbreiden met een nieuwe functie, maar eis dat ze de bestaande code eerst volledig herzien op leesbaarheid voordat ze iets toevoegen.
• Geef leerlingen die worstelen een template met vierkantjes voor variabelenamen en twee lege regels voor commentaar. Laat ze de code eerst invullen voordat ze het fragment herschrijven.
• Bied een diepere verkenning aan: laat leerlingen een open-source project kiezen, de naamgevingsconventies onderzoeken en een verbetervoorstel schrijven voor de community.

Kernbegrippen

Commentaar	Tekst in de code die door de programmeur is toegevoegd om uitleg te geven, maar genegeerd wordt door de computer. Het helpt de leesbaarheid voor mensen te vergroten.
Variabele naamgeving	Het proces van het kiezen van duidelijke, beschrijvende namen voor variabelen die hun doel en inhoud weerspiegelen, zoals 'aantalPogingen' in plaats van 'ap'.
Functie naamgeving	Het selecteren van heldere en actiegerichte namen voor functies of methoden, die aangeven wat de functie doet, bijvoorbeeld 'berekenGemiddelde' in plaats van 'calc'.
Leesbaarheid	De mate waarin code gemakkelijk te begrijpen is voor een mens, zowel voor de oorspronkelijke programmeur als voor anderen die de code later lezen of aanpassen.
Refactoring	Het proces van het herstructureren van bestaande computercode zonder de externe functionaliteit te veranderen, met als doel de leesbaarheid en onderhoudbaarheid te verbeteren.