Kwaliteitscriteria¶
Tekst¶
- Klein (maximaal 500 woorden)
- Beknopte alineas
- Beeldmateriaal (afbeeldingen, video’s, etc.)
- Tabellen
- code blokken
- Gebruik callouts waar nodig:
Code blokken¶
- Specificeer de taal van het code blok
- Gebruik kleine voorbeelden
- Probeer niet te veel taal specifieke code te laten zien
- Gebruik tabbed blocks voor verschillende talen
- Gebruik code annotaties waar nodig
Oefening¶
- Niet langer dan een half uur werk
- De opdracht draagt niet direct bij aan hun project maar is een oefening op zichzelf
- De opdracht levert iets aan documentatie op dat de student kan gebruiken bij het bewijzen van zijn of haar voortgang
Bronnen¶
- Verwijs naar zo veel mogelijk aanverwante onderwerpen in de knowledgebase
- Verwijs naar gebruikte bronnen
- Verwijs naar externe bronnen waar studenten meer kunnen leren
Voorbeeld¶
- Ieder artikel heeft minstens één voorbeeld