28. Vormgeving - Locatie Editor¶

Het doel van deze pagina is om bekend te raken met het taalgebruik en vormgeving van exercises in NexEd. Hoe wordt een exercise opgebouwd? Welke informatie geef je wel/niet aan een student? Welke bronnen gebruik je? Dat lees je hier terug.

28.1 Algemeen taalgebruik¶

Als een student een exercise leest, moet het de student activeren om aan de slag te gaan. Let daarom goed op de volgende onderdelen:

• Gebruik 'je' in plaats van 'we' of 'ik'.

• Minimaliseer het gebruik van verkleinwoorden.

• Gebruik voorbeelden die zowel mannen als vrouwen uit verschillende culturen aanspreken.

• Vermijd in je tekst aan te geven of een exercise makkelijk of moeilijk is.

• De tekst moet zowel geschikt voor studenten als volwassenen zijn. Vermijd daarom concepten die met school te maken hebben zoals klasgenoten, lessen of vakken.

28.2 Titels¶

Voor het taalgebruik van de titel van een exercise kan je één van drie richtingen kiezen:

1. Een leuke woordgrap: Bijvoorbeeld 'Een regulier begin' voor de eerste Regular Expression exercise, of 'Blokkendoos' voor een exercise over CSS display-block.
2. Techniek: De techniek die een student gaat leren. Bijvoorbeeld 'Template String' voor een exercise over template strings.
3. Project: Een project-achtige naam. Bijvoorbeeld 'Wat is je naam?' voor een exercise waarin je de gebruiker zijn naam vraagt.

28.3 Omschrijvingen¶

De omschrijving kan heel kort zijn of heel uitgebreid, hier zit geen limiet aan. Het doel van de omschrijving hangt af van het type exercise:

28.3.1 Opbouw¶

Binnen elk tekstvak in de Exercise Editor wordt Markdown ondersteund, waarmee je teksten kunt opmaken en structureren. Enkele tips voor maken van een goede omschrijving met Markdown:

Als het mogelijk is een onderwerp met een video of een GIF uit te leggen, heeft dit de voorkeur over het zelf uitschrijven in tekst. Beelden, geluid en animaties helpen om concepten visueel en auditief te verduidelijken, waardoor informatie beter blijft hangen.

28.4 Leerdoelen¶

Elke exercise heeft één of meer leerdoelen. Deze doelen beschrijven wat wij verwachten wat de student kan na het afronden van deze exercise. Voor het beschrijven van de leerdoelen gebruiken we de Taxonomie van Bloom.²

De sleutelwoorden uit onderstaande tabel kunnen je helpen om te verwoorden op welk niveau een student een vaardigheid moet beheersen:

28.4.1 Taalgebruik¶

De leerdoelen worden, net als de overige content, in de je-vorm geschreven:

28.5 Verwachte uitkomst alleen praktijk¶

In de omschrijving staat beschreven wat de student moet gaan bouwen. In de verwachte uitkomst is hier een voorbeeld zichtbaar. Dit kan zijn:

1. Voor veel command-line exercise maken we een MP4 om de uitwerking te tonen. Klik hier om te lezen hoe dit werkt.

Maak je een screenshot, video of GIF van een website? Laat dan ook het omhulsel van de browser zien:

28.6 Nakijkcriteria alleen praktijk¶

Als studenten exercises van elkaar nakijken, moet er duidelijk aangegeven worden waar er op gecontroleerd moet worden. Dit noteer je in de nakijkcriteria. Deze checklist moet duidelijk benoemen wat er gecontroleerd moet worden. Ze zijn ook zichtbaar voor de student die de uitwerking maakt, dus ze moeten niet direct het antwoord weggeven!

Bij het reviewen worden de nakijkencriteria een checklist, dus het is belangrijk ze als losse items in te voeren:

28.7 Voorbeelduitwerkingen alleen praktijk¶

Voor elke exercise is het verplicht een voorbeelduitwerking aan te leveren. Deze voorbeelduitwerking moet geldig zijn volgens de BLAST-linters en een voorbeeld zijn van goede code. Studenten kunnen deze uitwerking namelijk downloaden na het afronden van een exercise, zodat ze een goed voorbeeld kunnen inzien.

28.8 Self diagnostics¶

Als een student een level of module afrondt, wil je (en hij/zij ook) zeker weten dat de kennis die verwacht werd dat de student nu weet, ook echt aanwezig is. Zo voorkom je dat de student verder in het traject vastloopt.

28.8.1 Opbouw¶

• Onderwerp: Binnen een Self diagnostic krijg je vragen over één of meer onderwerpen.
• Checks: Per onderwerp heb je één of meerdere checks. Een check is een verzameling van vragen over een specifiek onderwerp of situatieschets.
• Vraag: Een check bestaat uit één of meer vragen. Een vraag heeft één of meer antwoordopties.

Wanneer een student een Self diagnostics begint, wordt per onderwerp willekeurig één van de checks gekozen. Zo voorkomen we dat als een student een Self diagnostic meerdere keren moet doen, hij/zij elke keer dezelfde vragen krijgt.

28.8.2 Frequentie¶

Probeer elke twee a drie levels een kleine Self diagnostic toe te voegen zodat zowel de student als jij met zekerheid kan zeggen dat de stof tot dan toe goed begrepen is. Dit stelt de coach ook in staat om snel in te grijpen als een student de stof niet goed blijkt te snappen.