Gebruik deze checklist voordat je een artikel publiceert om te controleren of het voldoet aan de normen voor zowel menselijke leesbaarheid als AI-terugvindbaarheid. Elk item is gekoppeld aan een best practice die behandeld wordt in Gen AI-vriendelijke content.
Structuur & koppen
- H1, H2 en H3 koppen worden hiërarchisch gebruikt, geen levels worden overgeslagen.
- Elke kop is beschrijvend en specifiek, niet generiek (vermijd "Overzicht", "Inleiding", "Details").
- Er wordt geen kop herhaald in hetzelfde artikel.
- Relevante trefwoorden verschijnen vanzelfsprekend in koppen.
Paragrafen & flow
- Straffen zijn kort. Bij voorkeur onder de 20 woorden en direct.
- Elke alinea behandelt één idee of taak.
- Filler, achtergrondcontext en tangentiële informatie worden verwijderd of apart gelinkt.
- Elke sectie is modulair en beknopt. Bij voorkeur minder dan 500 tokens (~375 woorden).
Lijsten & tabellen
- Opsommingstekens worden gebruikt voor gegroepeerde, ongeordende informatie.
- Genummerde lijsten worden gebruikt voor opeenvolgende stappen.
- Lijsten bevatten 3–7 items en elk item is parallel van structuur.
- Tabellen worden gebruikt voor gestructureerde data (parameters, instellingen, vergelijkingen).
- Alle tabelkolommen hebben beschrijvende headers.
- Alle tabelcellen bevatten beschrijvende tekst. Geen Y/N, streepjes, emoji's of iconen.
- Geen samengevoegde cellen of inconsistente tabelopmaak.
Codefragmenten
- Code is schoon, consistent ingesprongen en correct opgemaakt.
- Inline opmerkingen leggen logica en intentie uit.
- Syntaxismarkeringen of taaltags worden toegepast.
- Codeblokken zijn kopieerbaar. Geen regelnummers of decoratieve stijl.
- Voor API - of productspecifieke code is een contextstatement inbegrepen.
Afbeeldingen & links
- Elke afbeelding heeft betekenisvolle, beschrijvende alt-tekst.
- Alt-tekst vermijdt vage labels zoals "screenshot."
- Bijschriften of omliggende tekst bieden extra context waar nodig.
- Alle ankertekst is beschrijvend. Bijvoorbeeld: "Leer hoe je privéwerkruimtes beheert" in plaats van "hier," "dit," of "klik hier."
- Interne links verwijzen waar relevant naar gerelateerde artikelen.
SEO & metadata
- Trefwoorden verschijnen natuurlijk in koppen, sectieopeners en hoofdtekst.
- Een meta-beschrijving wordt geschreven met de belangrijkste trefwoorden van het artikel.
- Gestructureerde metadata (titeltag, beschrijving, aangepaste velden) worden toegepast waar dat ondersteund wordt.
- De terminologie is consistent met door het glossarium goedgekeurde termen.
Vaardigheden & AI-workflow
- Als er een SKILL.md is gebruikt, is de output vóór publicatie gecontroleerd op nauwkeurigheid en volledigheid.
- Geen enkele sectie werd zonder reden overgeslagen. Als een artikel wordt weggelaten, is het echt niet van toepassing.
- Stem en toon komen overeen met MSTP-conventies: tweede persoon, tegenwoordige tijd, actieve stem, geen marketingtaal.
- Veelgestelde vragen die door de vaardigheid worden geproduceerd, zijn op zichzelf staand en afkomstig van echte gebruikersvragen, niet uit gegenereerde opvulling.
GEO (Generatieve Engine Optimalisatie)
- Het artikel begint met een direct antwoord op de vraag van de primaire gebruiker binnen de eerste twee zinnen.
- Elke sectie is op zichzelf staand en is logisch als je die op zichzelf leest, zonder dat er context nodig is.
- Belangrijke termen en definities worden expliciet vermeld, niet afgenomen uit de context.
- Er wordt geen cruciale informatie midden in een lange alinea verstopt — het wordt genoemd in een kop, lijst of callout.
- De inhoud is zo gestructureerd dat AI een bruikbaar antwoord kan ophalen zonder het volledige artikel te lezen.
Woordenlijst & terminologie
- Goedgekeurde woordenlijsttermen worden precies zoals gedefinieerd gebruikt. Geen synoniemen of variaties.
- Onbekende termen worden bij de eerste vermelding gedefinieerd of gekoppeld.
- Afkortingen en acroniemen worden consequent gebruikt.
Schrijfstijl
- De toon is helder, gespreksmatig en gebruiksvriendelijk.
- Er wordt eenvoudige taal gebruikt; Jargon wordt vermeden of uitgelegd.
- Tweede persoon ("jij") wordt gebruikt in instructieve en how-to content.
Veelgestelde vragen
- Het artikel bevat 5–10 veelgestelde vragen in een speciale sectie.
- Vragen worden voortgebracht uit echte gebruikersvragen, supporttickets of veelvoorkomende productvragen.
- Elk FAQ-antwoord is op zichzelf staand en beknopt.
AI-specifieke controles
- AI-gegenereerde concepten die worden beoordeeld op nauwkeurigheid, toon en hallucinaties.
- Het artikel is getest in Eddy AI om nauwkeurige antwoorden te bevestigen.
- De inhoud is modulair genoeg om hergebruikt te worden in FAQ's, chatreacties en samenvattingen.
- Onbeantwoorde vragen of feedback op ondersteuning zijn beoordeeld en opgenomen.