diff --git a/CLAUDE.md b/CLAUDE.md index c4e0c8d..4827ccf 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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. `Label: description`) are fine and intentional. + ## Notes for Future Work - The backoffice elimination logic is in `Controller/Backoffice/PrepareEliminationController.php` diff --git a/templates/backoffice/help/nl/index.html.twig b/templates/backoffice/help/nl/index.html.twig index bfdc2c5..1f8595b 100644 --- a/templates/backoffice/help/nl/index.html.twig +++ b/templates/backoffice/help/nl/index.html.twig @@ -1,5 +1,5 @@
Aan de slag
-

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.

+

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.

Globale werkwijze
  1. Seizoen aanmaken en kandidaten toevoegen
  2. diff --git a/templates/backoffice/help/nl/quiz_add.html.twig b/templates/backoffice/help/nl/quiz_add.html.twig index e6ac612..f8e0f49 100644 --- a/templates/backoffice/help/nl/quiz_add.html.twig +++ b/templates/backoffice/help/nl/quiz_add.html.twig @@ -4,5 +4,5 @@ diff --git a/templates/backoffice/help/nl/quiz_overview.html.twig b/templates/backoffice/help/nl/quiz_overview.html.twig index 5b948ad..7954888 100644 --- a/templates/backoffice/help/nl/quiz_overview.html.twig +++ b/templates/backoffice/help/nl/quiz_overview.html.twig @@ -1,5 +1,5 @@
    Overzicht & afronden

    Vragen met een rode markering in de lijst hiernaast bevatten een fout. Herstel deze vóór het afronden.

    Afronden vergrendelt de test voor bewerking en maakt hem klaar voor kandidaten. Daarna kun je hem activeren.

    -

    Activeren stelt de test beschikbaar aan kandidaten. Er kan maar één test tegelijk actief zijn; activeer de volgende pas als iedereen de huidige heeft afgerond.

    +

    Activeren stelt de test beschikbaar aan kandidaten. Er kan maar één test tegelijk actief zijn, activeer de volgende pas als iedereen de huidige heeft afgerond.

    Test wissen verwijdert alle gegeven antwoorden en heft het afronden op, zodat je de test opnieuw kunt bewerken en uitvoeren.

    diff --git a/templates/backoffice/help/nl/quiz_question_bank_form.html.twig b/templates/backoffice/help/nl/quiz_question_bank_form.html.twig index 45d5bc2..24bae86 100644 --- a/templates/backoffice/help/nl/quiz_question_bank_form.html.twig +++ b/templates/backoffice/help/nl/quiz_question_bank_form.html.twig @@ -1,4 +1,4 @@
    Vraag toevoegen

    Voer de vraag in en voeg minimaal twee antwoordopties toe. Markeer precies één antwoord als correct.

    Gebruik labels om vragen te organiseren in de vragenbank, bijvoorbeeld per aflevering of type vraag.

    -

    Markeer een vraag als herbruikbaar als deze in meerdere testen mag voorkomen; anders kan een vraag maar aan één test worden gekoppeld.

    +

    Markeer een vraag als herbruikbaar als deze in meerdere testen mag voorkomen, anders kan een vraag maar aan één test worden gekoppeld.

    diff --git a/templates/backoffice/help/nl/season_add.html.twig b/templates/backoffice/help/nl/season_add.html.twig index 497592d..7b0157a 100644 --- a/templates/backoffice/help/nl/season_add.html.twig +++ b/templates/backoffice/help/nl/season_add.html.twig @@ -1,3 +1,3 @@
    Nieuw seizoen
    -

    Een seizoen groepeert alle testen en kandidaten voor één spel. Geef het seizoen een herkenbare naam; de seizoenscode wordt automatisch gegenereerd.

    +

    Een seizoen groepeert alle testen en kandidaten voor één spel. Geef het seizoen een herkenbare naam, de seizoenscode wordt automatisch gegenereerd.

    Na het aanmaken voeg je kandidaten toe en maak je testen aan via de seizoenpagina.

    diff --git a/templates/backoffice/help/nl/season_candidates.html.twig b/templates/backoffice/help/nl/season_candidates.html.twig index 2d3feda..bfabbb6 100644 --- a/templates/backoffice/help/nl/season_candidates.html.twig +++ b/templates/backoffice/help/nl/season_candidates.html.twig @@ -1,3 +1,3 @@
    Kandidaten
    -

    Dit zijn de spelers van dit seizoen. Voeg alle deelnemers toe voordat je de eerste test start; kandidaten worden automatisch aan nieuwe testen gekoppeld.

    -

    Namen zijn vrij in te voeren; gebruik dezelfde schrijfwijze die je in het spel gebruikt.

    +

    Dit zijn de spelers van dit seizoen. Voeg alle deelnemers toe voordat je de eerste test start, kandidaten worden automatisch aan nieuwe testen gekoppeld.

    +

    Namen zijn vrij in te voeren, gebruik dezelfde schrijfwijze die je in het spel gebruikt.

    diff --git a/templates/backoffice/help/nl/season_question_bank.html.twig b/templates/backoffice/help/nl/season_question_bank.html.twig index 5efe4f4..7b4b0e5 100644 --- a/templates/backoffice/help/nl/season_question_bank.html.twig +++ b/templates/backoffice/help/nl/season_question_bank.html.twig @@ -1,3 +1,3 @@
    Vragenbank

    De vragenbank is een bibliotheek met vragen die aan meerdere testen kunnen worden gekoppeld. Markeer een vraag als herbruikbaar als deze in meerdere testen mag voorkomen (bijv. "Wie is de Mol?").

    -

    Na het bewerken van een bankenvraag worden testen die de vraag al bevatten niet automatisch bijgewerkt; gebruik de synchronisatieknop (↻) naast een test om de meest recente versie door te zetten.

    +

    Na het bewerken van een bankenvraag worden testen die de vraag al bevatten niet automatisch bijgewerkt, gebruik de synchronisatieknop (↻) naast een test om de meest recente versie door te zetten.

    diff --git a/templates/backoffice/help/nl/season_tests.html.twig b/templates/backoffice/help/nl/season_tests.html.twig index 4018b24..bbe0c8c 100644 --- a/templates/backoffice/help/nl/season_tests.html.twig +++ b/templates/backoffice/help/nl/season_tests.html.twig @@ -1,6 +1,6 @@
    Testen beheren

    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.

    -

    Een test moet eerst afgerond zijn voordat je hem kunt activeren. Slechts één test kan tegelijk actief zijn; dit is de test die kandidaten op dat moment kunnen invullen.

    +

    Een test moet eerst afgerond zijn voordat je hem kunt activeren. Slechts één test kan tegelijk actief zijn, namelijk de test die kandidaten op dat moment kunnen invullen.

    Volgorde van werken
    1. Test aanmaken (Excel of leeg)