feat(docs): zeg het wanneer een document alleen in het Engels bestaat (#626) #692

Merged

brenno merged 2 commits from feat/docs-taalmelding-626 into main 2026-07-22 21:27:10 +00:00

Conversation 0 Commits 2 Files changed 37 +202 -14

brenno commented 2026-07-22 21:26:51 +00:00

Owner

Copy link

Sluit #626, langs jouw eigen voorstel: de kleinste goede oplossing is niet vertalen maar het zeggen.

De melding

De lezer toont één regel boven een document dat alleen in de basisversie bestaat, in de taal van de gebruiker. Een mededeling en geen waarschuwing — er is niets misgegaan, er is alleen iets er nog niet.

DocumentationService.loadDetailed geeft daarvoor terug óf de basisversie geserveerd is. load blijft bestaan voor het zoekpad, dat dit onderscheid niet nodig heeft.

En de README zegt het nu ook

De 32 talen zijn de interface; de documentatie is Engels. Met erbij dat de machinerie er al is: docs/USER_GUIDE.de.md ernaast zetten en de app pakt hem op. Meteen ook de zin over de taaltests bijgewerkt — er zijn er sinds #677 twee, en de tweede betrapt een "vertaling" die nog de Engelse zin is.

De test dekt de drie gevallen

Melding bij een niet-vertaald document in een andere taal, géén melding zodra er een vertaling naast ligt, en géén melding in het Nederlands — dat is de bron.

Die middelste is de belangrijkste: zet iemand later USER_GUIDE.de.md neer, dan moet de melding vanzelf verdwijnen. Blijft hij staan, dan vertelt hij een onwaarheid, en dan is hij erger dan geen melding.

Op de meldingstekst zélf toetsen kan niet: in het Duits geeft d() de Duitse zin terug, en die in de test herhalen zou de vertáling toetsen in plaats van het gedrag. Het icoon is wat de melding uniek maakt.

Wat dit nadrukkelijk niet is

De 19.382 regels vertalen. Dat is een project op zichzelf en het staat hier niet in. Maar zwijgen was het ook niet, want de app wekt de verwachting zélf met een vertaalde titel — en die asymmetrie is scherper dan plat "geen documentatie in jouw taal".

Poort

make check groen (niet door tail gepijpt), make l10n-check groen. Eén nieuwe d()-string, in alle 31 talen.

Sluit #626, langs jouw eigen voorstel: **de kleinste goede oplossing is niet vertalen maar het zeggen.** ## De melding De lezer toont één regel boven een document dat alleen in de basisversie bestaat, in de taal van de gebruiker. Een mededeling en geen waarschuwing — er is niets misgegaan, er is alleen iets er nog niet. `DocumentationService.loadDetailed` geeft daarvoor terug óf de basisversie geserveerd is. `load` blijft bestaan voor het zoekpad, dat dit onderscheid niet nodig heeft. ## En de README zegt het nu ook De 32 talen zijn de *interface*; de documentatie is Engels. Met erbij dat de machinerie er al is: `docs/USER_GUIDE.de.md` ernaast zetten en de app pakt hem op. Meteen ook de zin over de taaltests bijgewerkt — er zijn er sinds #677 twee, en de tweede betrapt een "vertaling" die nog de Engelse zin is. ## De test dekt de drie gevallen Melding bij een niet-vertaald document in een andere taal, géén melding zodra er een vertaling naast ligt, en géén melding in het Nederlands — dat *is* de bron. Die middelste is de belangrijkste: zet iemand later `USER_GUIDE.de.md` neer, dan moet de melding vanzelf verdwijnen. Blijft hij staan, dan vertelt hij een onwaarheid, en dan is hij erger dan geen melding. Op de meldingstekst zélf toetsen kan niet: in het Duits geeft `d()` de Duitse zin terug, en die in de test herhalen zou de vertáling toetsen in plaats van het gedrag. Het icoon is wat de melding uniek maakt. ## Wat dit nadrukkelijk niet is De 19.382 regels vertalen. Dat is een project op zichzelf en het staat hier niet in. Maar zwijgen was het ook niet, want de app wekt de verwachting zélf met een vertaalde titel — en die asymmetrie is scherper dan plat "geen documentatie in jouw taal". ## Poort `make check` groen (niet door `tail` gepijpt), `make l10n-check` groen. Eén nieuwe `d()`-string, in alle 31 talen.

brenno added 2 commits 2026-07-22 21:26:51 +00:00

feat(docs): zeg het wanneer een document alleen in het Engels bestaat (#626) ... c07d1c33af

Alle 24 gebundelde documenten bestaan alleen in het Engels; hun titels
staan in 32 talen. Wie de app op Pools zet, klikt op Help → Gebruikersgids
en krijgt een Poolse titel met 2.992 regels Engels eronder.

Die 32-tegen-0 is scherper dan "geen documentatie in jouw taal", want de
app wekt de verwachting zélf: een vertaalde titel op een onvertaald
document. De machinerie voor een `.pl.md` ernaast bestond al — wat
ontbrak was dat het scherm er iets over zei.

De lezer toont nu één regel boven zo'n document, in de taal van de
gebruiker. Een mededeling en geen waarschuwing: er is niets misgegaan, er
is alleen iets er nog niet. `DocumentationService.loadDetailed` geeft
daarvoor terug óf het de basisversie was; `load` blijft bestaan voor het
zoekpad, dat dit onderscheid niet nodig heeft.

Nadrukkelijk niet de grote oplossing. 19.382 regels vertalen is dat wel,
en dat is een project op zichzelf; zwijgen is het ook niet. Wie later één
taal wil, zet `docs/USER_GUIDE.de.md` ernaast en de rest werkt al.

README zegt nu dat de 32 talen de *interface* zijn en de documentatie
Engels — plus dat er sinds #677 een tweede poort is die een "vertaling"
betrapt die nog de Engelse zin is.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

test(docs): dek de taalmelding af, en geef wrap() een taal ... aa88773e52

Drie gevallen: de melding staat er bij een niet-vertaald document in een
andere taal, hij staat er niet zodra er een vertaling naast ligt, en hij
staat er niet in het Nederlands — dat ís de bron.

Op de meldingstekst zelf toetsen kan niet: in het Duits geeft `d()` de
Duitse zin terug, en die hier herhalen zou de vertaling toetsen in plaats
van het gedrag. Het icoon is wat de melding uniek maakt.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

brenno merged commit 363a669fdb into main 2026-07-22 21:27:10 +00:00

brenno referenced this pull request from a commit 2026-07-22 21:27:10 +00:00

Merge pull request 'feat(docs): zeg het wanneer een document alleen in het Engels bestaat (#626)' (#692) from feat/docs-taalmelding-626 into main

brenno referenced this pull request 2026-07-22 21:27:11 +00:00

[Feature] Every bundled document is English while its reader tile is translated 32 ways #626

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

accepted

Assessed and will be built

  

bug

Something is broken

  

declined

Assessed and will not be built

  

docs

Documentation only

  

duplicate

Already tracked elsewhere

  

enhancement

New feature or improvement request

  

good first issue

Small, self-contained, and a good place to start

  

in-progress

Someone is working on this right now. Do not start it in parallel.

  

needs-info

Waiting for the reporter

  

privacy

Personal data can leak. Handled before anything else.

  

security

A weakness someone could use. Handled before anything else.

  

triage

Awaiting assessment

No labels

accepted

bug

declined

docs

duplicate

enhancement

good first issue

in-progress

needs-info

privacy

security

triage

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

LibreKAT/Ocideck!692

No description provided.