Skip to content

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