Websiteteksten voorbereiden voor Claude Code: inhoudsplan per pagina

Je wilt een website bouwen met Claude Code, maar de teksten moeten nog geschreven worden. Begin dan met een inhoudsplan: een overzicht van wat elke pagina moet beantwoorden, welke feiten je al hebt en wat nog ontbreekt. Je hoeft geen afgewerkte brochure aan te leveren. Wel moet duidelijk zijn welke informatie betrouwbaar is en welke keuzes nog openstaan.

Met een inhoudsplan kun je tekst en ontwerp samen beoordelen. Een lange dienstenomschrijving vraagt een andere indeling dan drie korte punten. Een ontbrekende foto heeft gevolgen voor een beeldsectie. En een knop kan pas een bruikbare tekst krijgen wanneer je weet waar die naartoe leidt.

1. Geef elke pagina één duidelijke opdracht

Maak eerst een lijst van de pagina’s die je bezoekers nodig hebben. Noteer per pagina welke vraag iemand daar komt beantwoorden en wat een passende volgende stap is. Begin met je aanbod en de beslissingen van je bezoeker; een lange lijst pagina’s maakt een website niet automatisch nuttiger.

Voor een fictieve fietsenmaker zou het overzicht bijvoorbeeld zo kunnen beginnen:

• Homepage: wat doet deze zaak en waar kan ik terecht? Volgende stap: de reparaties bekijken.
• Reparaties: welke werkzaamheden zijn mogelijk en hoe maak ik een afspraak? Volgende stap: contact opnemen.
• Over de zaak: wie voert de werkzaamheden uit en wat is de werkwijze? Volgende stap: de praktische informatie bekijken.
• Contact: waar vind ik de zaak, wanneer is ze bereikbaar en hoe stel ik mijn vraag? Volgende stap: bellen of een aanvraag starten.

Dit is een denkvoorbeeld, geen beschrijving van een bestaande klant. Een webshop, portfolio of softwareproduct heeft andere taken en kan dus andere pagina’s nodig hebben.

Als twee pagina’s dezelfde vraag beantwoorden, onderzoek dan of ze beter samen kunnen. Als een pagina verschillende belangrijke beslissingen bevat, kun je de inhoud soms beter verdelen. Kies de structuur die de informatie begrijpelijk maakt.

Voor de inhoudelijke opbouw van de startpagina kun je daarna onze gids over wat er op een homepage moet staan gebruiken.

2. Verzamel feiten voordat je zinnen laat schrijven

Maak een klein brondocument met informatie die je kunt controleren. Denk aan de juiste bedrijfsnaam, contactgegevens, aanbod, werkgebied, werkwijze en eventuele prijzen. Vermeld waar gegevens vandaan komen en wie ze kan bevestigen.

Schrijf bijvoorbeeld niet alleen “we leveren snel”, maar noteer welke afspraak je werkelijk kunt maken. Is er geen vaste levertijd, dan hoort er geen vaste belofte op de site. Hetzelfde geldt voor aantallen klanten, ervaring, certificeringen en resultaten.

Gebruik drie duidelijke statussen voor je materiaal:

• Bevestigd: gecontroleerde informatie die in de tekst mag worden gebruikt.
• Te bevestigen: informatie waarvoor nog een bron of beslissing nodig is.
• Voorbeeld: tijdelijke tekst die alleen helpt om een indeling te beoordelen.

Een voorbeeldtekst is geschikt om een ontwerp te bekijken, maar mag niet ongemerkt een publieke productclaim worden. Zet ontbrekende feiten in je werkdocument tussen herkenbare markeringen, zoals [NOG BEVESTIGEN: openingsuren]. Spreek af dat de pagina pas klaar is wanneer die markeringen zijn opgelost of de betreffende inhoud bewust is verwijderd.

3. Maak een inhoudsfiche per pagina

Een fiche voorkomt dat een opdracht verspreid raakt over losse berichten. Bewaar de fiches bijvoorbeeld in een map met projectdocumenten. Kies een formaat dat je zelf makkelijk bijwerkt, zoals Markdown of een gedeeld tekstbestand.

Gebruik per pagina deze velden:

1. Paginanaam en route: welke pagina is dit en bestaat de URL al?
2. Bezoeker en vraag: wie leest dit en wat moet die persoon begrijpen?
3. Hoofdboodschap: de belangrijkste informatie in één concrete zin.
4. Inhoudsblokken: welke uitleg is nodig en in welke volgorde?
5. Feiten en bronnen: wat mag zonder aanname in de tekst staan?
6. Volgende stap: knoptekst en de werkelijke bestemming of handeling.
7. Beelden: beschikbaar bestand, gebruiksrecht en wat het beeld verduidelijkt.
8. Open punten: wat moet nog worden geschreven, gecontroleerd of beslist?

Voor de fictieve reparatiepagina kan de hoofdboodschap zijn: “Bekijk welke fietsreparaties de zaak uitvoert en hoe je een afspraak aanvraagt.” De inhoudsblokken kunnen bestaan uit werkzaamheden, de manier van aanmelden en praktische informatie. Voeg een prijsblok alleen toe wanneer er bevestigde prijsinformatie is.

De fiche beschrijft de inhoud. Je hoeft nog niet te beslissen of ieder blok een kaart, tabel of brede sectie wordt. Dat kun je beoordelen zodra de tekst en de belangrijkste afbeeldingen beschikbaar zijn.

4. Schrijf een eerste versie die je kunt controleren

Werk eerst de kerninformatie uit. Schrijf de uitleg die iemand nodig heeft om een beslissing te nemen, en maak daarna de zinnen vloeiender. Een gewone, precieze zin is vaak makkelijker te beoordelen dan een algemene slogan.

Vergelijk bijvoorbeeld “Wij ontzorgen je volledig” met “Je stuurt je vraag via het formulier. Daarna bespreken we welke werkzaamheden nodig zijn.” De tweede formulering geeft een proces dat je kunt bevestigen of corrigeren. Gebruik zo’n procesomschrijving alleen als het werkelijk je werkwijze is.

Controleer per tekstblok:

• ☐ De tekst beantwoordt een vraag uit de inhoudsfiche.
• ☐ Iedere belofte klopt met het echte aanbod.
• ☐ Vakwoorden zijn uitgelegd waar de lezer ze nodig heeft.
• ☐ De belangrijkste informatie staat ook als tekst op de pagina.
• ☐ Knopteksten beschrijven een herkenbare volgende stap.
• ☐ Tijdelijke gegevens en voorbeelden zijn duidelijk gemarkeerd.

Laat meerdere versies alleen maken wanneer je iets concreets wilt vergelijken, bijvoorbeeld een korte en een uitgebreidere uitleg. Kies vervolgens op duidelijkheid en juistheid. Een tekst klinkt overtuigend wanneer de inhoud specifiek is; daarvoor hoef je geen superlatieven of verzonnen bewijs toe te voegen.

5. Geef Claude Code een begrensde inhoudsopdracht

Verwijs in je opdracht naar de inhoudsfiche en de bevestigde bronnen. Vraag om ontbrekende informatie te benoemen en leg uit welke feiten niet ingevuld mogen worden. Anthropic raadt in zijn documentatie aan om specifieke context, relevante bestanden en controlecriteria mee te geven. (Claude Code: best practices)

Onderstaande briefing is een eigen voorbeeld dat je kunt aanpassen. Vul de paden en de route in voor jouw project.

Bereid de inhoud voor van [paginanaam] op [route].

Lees eerst de projectafspraken en de inhoudsfiche in [bestand].
Gebruik voor feitelijke uitspraken alleen [bevestigde bronnen].

De bezoeker wil weten: [belangrijkste vraag].
De gewenste volgende stap is: [handeling en bestemming].

Maak eerst een tekstvoorstel per inhoudsblok.
Benoem ontbrekende feiten en onduidelijke keuzes.
Verzin geen prijzen, resultaten, klantquotes of bedrijfsgegevens.
Markeer ontbrekende informatie zichtbaar in het voorstel.

Gebruik een duidelijke, concrete toon in het Nederlands.
Controleer of elke knoptekst past bij de bedoelde handeling.

Wacht met implementeren tot de inhoud is goedgekeurd.
Publiceer het tekstvoorstel niet.

Zodra de inhoud klopt, kun je een afzonderlijke opdracht geven om de pagina op te bouwen. Heb je ook een visuele richting nodig, gebruik dan de gids om website-inspiratie te vertalen naar een eigen stijlbriefing. Voor afspraken die telkens terugkomen, zoals de gebruikte taal of vaste productgrenzen, is de gids over CLAUDE.md voor je websiteproject relevant.

6. Beoordeel de inhoud in de echte pagina

Een tekst die goed leest in een document kan op een telefoon te veel ruimte innemen, onder een verkeerde kop belanden of naast een onduidelijk beeld staan. Bekijk de pagina daarom na implementatie met de echte tekst en beelden.

Controleer de pagina van boven naar beneden en volg de links alsof je voor het eerst op de site komt. Lees ook de knopteksten buiten de context van de vorige alinea: blijft duidelijk wat je ermee doet?

• ☐ Paginatitel en hoofdkop passen bij de inhoud.
• ☐ Er staan geen voorbeeldnamen, tijdelijke prijzen of open markeringen meer.
• ☐ Contactgegevens en praktische informatie zijn bevestigd.
• ☐ Afbeeldingen passen bij de tekst en mogen worden gebruikt.
• ☐ Links en knoppen leiden naar de afgesproken bestemming.
• ☐ De belangrijkste uitleg blijft leesbaar op een klein scherm.
• ☐ Iemand is verantwoordelijk voor toekomstige inhoudelijke updates.

Werk fouten bij in zowel de pagina als het brondocument. Anders kan een volgende opdracht oude informatie opnieuw gebruiken. Neem daarna de mobiele websitechecklist erbij om de weergave en bediening te controleren.

Je inhoudsplan hoeft niet lang te zijn. Het moet genoeg houvast geven om tekst, beeld en paginaopbouw op echte informatie te baseren. Wil je die afspraken omzetten in een uitvoerbare opdracht? Met de gratis briefing voor Claude Code kun je de gewenste uitkomst en controlepunten verder vastleggen.