Controlekaart documenten AIM*

Een document dient aan al onderstaande criteria te voldoen.

Algemeen

  1. Lever het document op tijd in en op de juiste plek en manier.
  2. Het document oogt netjes (geen verspringend lettertype, geen inktvegen, geen rommelige vormgeving en geen onleesbare stukken tekst).
  3. Voorzie het document van een titel, studentnaam of -namen (alfabetisch geordend), studentnummers, klas, groepsnummer, docentnaam of -namen, datum, course/semestergegevens en versienummer.
  4. Voorzie het document van een inhoudsopgave en paginanummers.

Opbouw

  1. Structureer je document door een goede indeling in hoofdstukken, en een hoofdstuk in paragrafen en alinea's. Het document bevat in ieder geval een inleiding, kerntekst en conclusie.
  2. Bijlagen, plaatjes en tabellen zijn een zinvolle aanvulling op de hoofdtekst.
  3. Gebruik APA-bronvermelding: een APA-literatuurlijst achteraan en in de tekst verwijzingen naar deze bronnen bij quotes of parafrases.

Stijl, spelling en grammatica

  1. Schrijf het document doel- en doelgroepsgericht en hou in de schrijfstijl rekening met de doelgroep.
  2. Spel vervoegingen van werkwoorden correct. Er staan maximaal drie foutief gespelde werkwoorden op een willekeurige pagina.
  3. Spel woorden correct. Er staan maximaal drie foutief gespelde woorden op een willekeurige pagina.
  4. Het document is in de actieve vorm geschreven. Je schrijft het document in de actieve vorm. Het bevat nagenoeg geen lijdende zinnen.

*Noot: Bovenstaande tekst is overgenomen van de 'factlearning' Wordpress site van ICA AIM Professional skills (2016). Dat is niet meest recente, maar op dit moment nog wel dé beste plek om via Google deze controlekaart te vinden :P.

Overzicht en toelichting aanpassingen

In deze 'markdown' versie zijn t.o.v. het origineel:

  • de controlepunten ook voorzien van markdown checkboxen om af te vinken voor het inleveren/uploaden: [ ] -> [x]
  • De eisen in de actieve vorm geschreven, ook het punt over het vermijden van lijdende vorm, i.v.m. 'eat your own dogfood'
  • irrelevante punten voor markdown/digitale documenten zoals 'paginanummers' en 'geen inktvegen' doorgestreept

Merk op dat de meeste punten in het digitale tijdperk gewoon nog gelden. Een automatische/interactieve inhoudsopgave/TOC kun in markdown kun je makkelijk genereren met tools bv. in Visual Studio Code)

Nu je ChatGPT kunt gebruiken om je te helpen/teksten te herschrijven moet je makkelijk foutloos kunnen schrijven i.p.v. 3 fouten per pagina. Meer moeite heeft ChatGPT met in actieve vorm schrijven, of het herschrijven hiernaar.

Maar ook moderne bronnen zoals Google's Technical writing course (Google, 2022) onderstrepen dit punt alleen nog maar, o.a.:

  • Passive voice obfuscates your ideas, turning sentences on their head. Passive voice reports action indirectly.
  • Some passive voice sentences omit an actor altogether, which forces the reader to guess the actor's identity.
  • Active voice is generally shorter than passive voice.

En IBM () geeft voor requirements aan:

"Effective requirements clearly state who or what performs an action. Rewrite the requirement to clearly identify and focus on the actor."

Bart van der Wal - September 2023, updated oktober 2025.

Bronnen

Last change: 2025-12-05