Zo test je of een artikel het probleem van de lezer oplost

Schrijf vóór je de tekst beoordeelt de uitgangsformulering van de audit op:

Lezer: [specifiek type persoon]. Bedoeling: [wat die persoon wil begrijpen of beslissen]. Taak: Na het lezen kan die persoon [waarneembare handeling] uitvoeren zonder een niet-vermelde stap of bron nodig te hebben.

Bijvoorbeeld:

Lezer: Een redacteur die een praktisch webartikel beoordeelt. Bedoeling: Bepalen of de tekst de beoogde lezer helpt. Taak: Een audit van het voltooiingstraject uitvoeren en onderbouwd besluiten om te publiceren, te herzien of af te wijzen.

Dit onderscheid is belangrijk. ‘Meer leren over contentkwaliteit’ is een informatiethema, geen toetsbare taak. ‘De ontbrekende voorwaarde in een instructieartikel vaststellen en de betreffende sectie aanpassen’ is wel toetsbaar.

Houd de reikwijdte beperkt genoeg om een duidelijk eindpunt te hebben. Een gids kan uitleggen hoe je twee producten vergelijkt, een document voorbereidt, een instelling oplost of tussen opties kiest. Hij hoeft niet elke aanverwante vraag te beantwoorden om de omschreven taak uit te voeren.

De richtlijnen voor content en publicatie van GOV.UK adviseren om de behoeften van gebruikers vast te stellen en content daarop af te stemmen. Ook de zelfbeoordelingsvragen van Google vragen of de beoogde doelgroep de content nuttig vindt, of lezers genoeg leren om hun doel te bereiken en of ze een bevredigende ervaring hebben (Google Search Central). Dit zijn bruikbare aanknopingspunten, maar de redacteur moet ze nog omzetten in een concrete voltooiingstest.

Noteer in de juiste volgorde welke handelingen een lezer moet uitvoeren om de taak te voltooien. Neem beslissingen, berekeningen, invoer, controles en overdrachten op, niet alleen de koppen van het artikel.

Een praktische kaart kan er zo uitzien:

Markeer vervolgens elke stap als behandeld, deels behandeld of ontbrekend. ‘Behandeld’ betekent dat de lezer op basis van het artikel kan handelen, niet alleen dat het onderwerp wordt genoemd.

Een artikel over een budgetwerkblad kan bijvoorbeeld uitleggen hoe je uitgaven optelt, maar niet vermelden welke periode je moet gebruiken, of belastingen in het totaal horen of hoe je een onregelmatige rekening verwerkt. De centrale berekening is aanwezig, maar het voltooiingstraject loopt vast bij de invoer.

Een bruikbare audittabel is:

Deze tabel laat zien of de tekst als hulpmiddel compleet is. Ook voorkomt hij dat een redacteur een gepolijste inleiding beloont en een ontbrekende voorwaarde over het hoofd ziet.

Veel praktische artikelen schieten al tekort voordat de eerste instructie begint, omdat ze uitgaan van kennis, toegang of omstandigheden waarover de lezer niet beschikt. Controleer elke stap met vier vragen:

Vermeld aannames expliciet. Als een berekening een percentage gebruikt, definieer dan de basis. Als een installatiehandleiding afhankelijk is van een bepaalde softwareversie, vermeld dan de relevante versie of functie. Als een artikel opties vergelijkt, geef dan aan onder welke omstandigheden elke optie geschikt is.

Maak onderscheid tussen noodzakelijke invoer en optionele verbeteringen. De lezer moet kunnen zien of iets nodig is om verder te gaan of alleen handig is. Zet voorwaarden vóór de procedure, zodat ze onnodige inspanning kunnen voorkomen.

Let ook op verborgen bewerkingen. Moet de lezer eenheden omrekenen, spaties verwijderen, een datumbereik selecteren of een foutmelding interpreteren? Geef dan de regel of een klein voorbeeld ter illustratie. Vul ontbrekende invoer niet stilzwijgend zelf in. Vertel de lezer wat die moet opzoeken, welke aanname moet worden vastgelegd of wanneer de methode niet kan worden voltooid.

Een artikel is betrouwbaarder wanneer het duidelijk beschrijft wanneer iets misgaat. ‘Als het resultaat leeg is, controleer dan of het bronveld is ingevuld’ is nuttiger dan de indruk wekken dat de methode altijd werkt. De audit moet elk punt vastleggen waarop een lezer redelijkerwijs kan vastlopen.

Vraag je bij elke belangrijke claim af welke onderbouwing nodig is. Een definitie kan een gezaghebbende bron vereisen. Een procedurele instructie kan een handleiding van de oorspronkelijke aanbieder of een gedocumenteerde specificatie nodig hebben. Een aanbeveling kan vragen om expliciete criteria en een heldere uitleg van hoe die criteria tot de aanbeveling leiden.

Maak een register van claims met vier kolommen: claim, beïnvloede beslissing van de lezer, gebruikt bewijsmateriaal en stelligheid van de formulering. Die laatste kolom is belangrijk. Bewijsmateriaal kan ‘kan’, ‘meestal’ of ‘is vereist’ ondersteunen, maar niet automatisch ‘altijd’, ‘beste’ of ‘gegarandeerd’. Neem voorwaarden en beperkingen uit de bron over.

Geef de voorkeur aan oorspronkelijke bronnen of bronnen van de eerste partij wanneer die het onderwerp zelf documenteren. De uitleg van W3C over het WCAG 2.2-criterium Leesniveau stelt bijvoorbeeld dat complexe tekst een versie in eenvoudiger taal of aanvullende content moet hebben wanneer het gespecificeerde leesniveau wordt overschreden. Een redacteur kan die bron gebruiken om een controle op complexiteit te onderbouwen, maar moet vermijden de niet-onderbouwde conclusie te trekken dat één leesbaarheidsscore elk artikel toegankelijk maakt.

Zet bewijsmateriaal naast de claim die het ondersteunt, zoals in dat voorbeeld, en niet in een niet-gerelateerde bronnenlijst. Een bronnenlijst is nuttig voor de beoordeling, maar kan geen alinea repareren waarvan de formulering verder gaat dan het bewijsmateriaal toelaat. Controleer datums, versies en reikwijdte, vooral bij instructies die afhankelijk zijn van software, normen of beleid.

Een leesbaar artikel is niet alleen prettig om te lezen; het vermindert de moeite die nodig is om een instructie te vinden, begrijpen en toepassen. Beoordeel de tekst op het moment dat de lezer hem gebruikt:

De richtlijnen van W3C leggen uit dat korte, gangbare woorden en kortere zinnen doorgaans makkelijker te begrijpen zijn. Ze vermelden ook dat complexe onderwerpen geschikt kunnen zijn voor een gespecialiseerd publiek. Bij redigeren moet je dus onnodige moeilijkheden wegnemen zonder noodzakelijke precisie te verliezen. Vereenvoudig geen voorwaarde die het resultaat verandert.

Gebruik tabellen voor terugkerende vergelijkingen, genummerde lijsten voor reeksen en korte alinea’s voor redeneringen. Als een stap een beslissing vereist, zet de voorwaarde dan direct vóór de handeling. Als een term onvermijdelijk is, definieer die dan bij het eerste gebruik en gebruik daarna steeds dezelfde term.

Lees het artikel één keer als iemand die er snel doorheen bladert en één keer als iemand die de taak uitvoert. De snelle lezer moet het beloofde resultaat, de voorwaarden en de route naar het antwoord kunnen vinden. De uitvoerder moet de stappen kunnen doorlopen zonder de bedoelde volgorde van de auteur zelf te moeten reconstrueren.

De beste controle vóór publicatie is een kleine taaktest met iemand die op de beoogde lezer lijkt, maar de tekst niet heeft geschreven. Geef die persoon de taakomschrijving en het artikel. Vraag die zelfstandig te werken en alleen hardop te vertellen waar die kijkt of wat die nodig heeft, niet of die het artikel prettig vindt.

Kijk of die persoon:

Leg concrete struikelpunten vast: een ontbrekend veld, onduidelijk label, overgeslagen voorwaarde, onverklaard resultaat of externe afhankelijkheid. Beschouw een geslaagde gok van een lezer niet als bewijs dat het artikel duidelijk is. Vraag: ‘Wat in het artikel vertelde je dat je dat moest doen?’ Als het antwoord ‘Dat wist ik al’ is, kan er nog steeds een leemte in de tekst zitten.

Deel elk probleem na de test in als blokkerend, vertragend of cosmetisch. Los eerst de blokkerende problemen op: ontbrekende voorwaarden, gevaarlijke onduidelijkheid, onjuiste volgorde en ontbrekende routes voor uitzonderingen. Test daarna het aangepaste traject opnieuw. Een lezerstest bewijst niet dat het artikel voor iedereen nuttig is, maar kan wel blootleggen of iemand anders dan de auteur de omschreven taak kan uitvoeren.

Analyses kunnen laten zien wat er na publicatie is gebeurd, zoals bezoeken, zoekopdrachten, uitstappen of interacties, maar bewijzen op zichzelf niet dat een lezer de taak heeft voltooid. Een kort bezoek kan betekenen dat het antwoord snel is gevonden; een lang bezoek kan betekenen dat de lezer in verwarring is. Beschouw gedragsgegevens als aanleiding voor onderzoek, niet als vervanging van de audit van het voltooiingstraject.

Als er gegevens beschikbaar zijn, koppel die dan aan een specifieke hypothese: ‘Misschien vinden lezers de voorwaarde niet’ of ‘De route voor het oplossen van problemen is mogelijk onduidelijk.’ Bekijk de relevante sectie, herhaal de taaktest en pas de tekst alleen aan wanneer het bewijsmateriaal die wijziging ondersteunt. Maak van een meetwaarde geen claim over bruikbaarheid zonder de uitkomst voor de lezer waar te nemen of op een andere manier te verifiëren.

De richtlijnen van Google voor content gericht op mensen vragen makers om de kwaliteit, bronnen en volledigheid van content te beoordelen en na te gaan of lezers hun doel bereiken. Die vragen sluiten aan bij deze audit, maar geen enkel document van een zoekmachine kan garanderen dat een afzonderlijk concept een afzonderlijke taak oplost. De redactionele beslissing blijft gebaseerd op de tekst, het bewijsmateriaal en het waargenomen traject.