style: replace semicolons with commas in nl help content, document writing rules

Semicolons in help text read as AI-generated; commas are more natural. Added writing style rules to CLAUDE.md to prevent recurrence.
2026-07-05 23:20:18 +02:00 · 2026-07-05 11:36:34 +02:00
parent dde1f9a0b1
commit 3d6bb88837
9 changed files with 18 additions and 9 deletions
@@ -224,6 +224,15 @@ Auto-executed scripts on install/update:
 - `assets:install` - Copy public assets
 - `importmap:install` - JS import map setup
 ## Writing Style (Help Content & UI Text)
 When writing Dutch help content in `templates/backoffice/help/nl/`:
 - **No em-dashes** (—): use a comma or restructure the sentence instead.
 - **No semicolons** (;): use a comma. Semicolons are technically correct but read as AI-generated text.
 - **Natural Dutch**: write the way a person would explain it to a colleague, not in formal documentation style.
 - **Colons after bold labels** (e.g. `<strong>Label:</strong> description`) are fine and intentional.
 ## Notes for Future Work
 - The backoffice elimination logic is in `Controller/Backoffice/PrepareEliminationController.php`
@@ -1,5 +1,5 @@
 <h6>Aan de slag</h6>
-<p>Elk seizoen groepeert één spel met alle bijbehorende testen en kandidaten. De seizoenscode is de link die kandidaten gebruiken om een test te starten; deze link is alleen actief als er een actieve test is.</p>
+<p>Elk seizoen groepeert één spel met alle bijbehorende testen en kandidaten. De seizoenscode is de link die kandidaten gebruiken om een test te starten, en is alleen actief als er een actieve test is.</p>
 <h6>Globale werkwijze</h6>
 <ol>
    <li><strong>Seizoen aanmaken</strong> en kandidaten toevoegen</li>
@@ -4,5 +4,5 @@
 <ul>
    <li>Eerste kolom: de vraagtekst</li>
    <li>Volgende kolommen: de antwoordopties</li>
-    <li>Markeer het juiste antwoord met <strong>WAAR</strong> (Nederlandstalige Excel) of <strong>TRUE</strong> (Engelstalige Excel); alle andere antwoorden laat je leeg of zet je op ONWAAR/FALSE</li>
+    <li>Markeer het juiste antwoord met <strong>WAAR</strong> (Nederlandstalige Excel) of <strong>TRUE</strong> (Engelstalige Excel), alle andere antwoorden laat je leeg of zet je op ONWAAR/FALSE</li>
 </ul>
@@ -1,5 +1,5 @@
 <h6>Overzicht &amp; afronden</h6>
 <p>Vragen met een rode markering in de lijst hiernaast bevatten een fout. Herstel deze vóór het afronden.</p>
 <p><strong>Afronden</strong> vergrendelt de test voor bewerking en maakt hem klaar voor kandidaten. Daarna kun je hem activeren.</p>
-<p><strong>Activeren</strong> stelt de test beschikbaar aan kandidaten. Er kan maar één test tegelijk actief zijn; activeer de volgende pas als iedereen de huidige heeft afgerond.</p>
+<p><strong>Activeren</strong> stelt de test beschikbaar aan kandidaten. Er kan maar één test tegelijk actief zijn, activeer de volgende pas als iedereen de huidige heeft afgerond.</p>
 <p><strong>Test wissen</strong> verwijdert alle gegeven antwoorden en heft het afronden op, zodat je de test opnieuw kunt bewerken en uitvoeren.</p>
@@ -1,4 +1,4 @@
 <h6>Vraag toevoegen</h6>
 <p>Voer de vraag in en voeg minimaal twee antwoordopties toe. Markeer precies één antwoord als correct.</p>
 <p>Gebruik labels om vragen te organiseren in de vragenbank, bijvoorbeeld per aflevering of type vraag.</p>
-<p>Markeer een vraag als <em>herbruikbaar</em> als deze in meerdere testen mag voorkomen; anders kan een vraag maar aan één test worden gekoppeld.</p>
+<p>Markeer een vraag als <em>herbruikbaar</em> als deze in meerdere testen mag voorkomen, anders kan een vraag maar aan één test worden gekoppeld.</p>
@@ -1,3 +1,3 @@
 <h6>Nieuw seizoen</h6>
-<p>Een seizoen groepeert alle testen en kandidaten voor één spel. Geef het seizoen een herkenbare naam; de seizoenscode wordt automatisch gegenereerd.</p>
+<p>Een seizoen groepeert alle testen en kandidaten voor één spel. Geef het seizoen een herkenbare naam, de seizoenscode wordt automatisch gegenereerd.</p>
 <p>Na het aanmaken voeg je kandidaten toe en maak je testen aan via de seizoenpagina.</p>
@@ -1,3 +1,3 @@
 <h6>Kandidaten</h6>
-<p>Dit zijn de spelers van dit seizoen. Voeg alle deelnemers toe voordat je de eerste test start; kandidaten worden automatisch aan nieuwe testen gekoppeld.</p>
+<p>Dit zijn de spelers van dit seizoen. Voeg alle deelnemers toe voordat je de eerste test start, kandidaten worden automatisch aan nieuwe testen gekoppeld.</p>
-<p>Namen zijn vrij in te voeren; gebruik dezelfde schrijfwijze die je in het spel gebruikt.</p>
+<p>Namen zijn vrij in te voeren, gebruik dezelfde schrijfwijze die je in het spel gebruikt.</p>
@@ -1,3 +1,3 @@
 <h6>Vragenbank</h6>
 <p>De vragenbank is een bibliotheek met vragen die aan meerdere testen kunnen worden gekoppeld. Markeer een vraag als <em>herbruikbaar</em> als deze in meerdere testen mag voorkomen (bijv. "Wie is de Mol?").</p>
-<p>Na het bewerken van een bankenvraag worden testen die de vraag al bevatten <strong>niet</strong> automatisch bijgewerkt; gebruik de synchronisatieknop (↻) naast een test om de meest recente versie door te zetten.</p>
+<p>Na het bewerken van een bankenvraag worden testen die de vraag al bevatten <strong>niet</strong> automatisch bijgewerkt, gebruik de synchronisatieknop (↻) naast een test om de meest recente versie door te zetten.</p>
@@ -1,6 +1,6 @@
 <h6>Testen beheren</h6>
 <p>Voeg een test toe vanuit een Excel-bestand of maak een lege test aan en vul deze via de vragenbank. Open daarna de test om hem te bekijken en af te ronden.</p>
-<p>Een test moet eerst <strong>afgerond</strong> zijn voordat je hem kunt activeren. Slechts één test kan tegelijk actief zijn; dit is de test die kandidaten op dat moment kunnen invullen.</p>
+<p>Een test moet eerst <strong>afgerond</strong> zijn voordat je hem kunt activeren. Slechts één test kan tegelijk actief zijn, namelijk de test die kandidaten op dat moment kunnen invullen.</p>
 <h6>Volgorde van werken</h6>
 <ol>
    <li>Test aanmaken (Excel of leeg)</li>