[Bug] Engelse handleiding als de taal naar Nederlands is gezet #1181

Closed
opened 2026-08-03 19:00:47 +00:00 by reinoud · 6 comments

Describe the bug
Ik heb de taal in het Nederlands ingesteld, maar de ingebouwde handleiding is in het Engels

Expected behaviour
Ik had verwacht dat de handleiding in de taal zou zijn die de rest van de applicatie gebruikt

Environment

  • OciDeck version: 0.2.0 (5)
  • OS and version: MacOS 26.5.2
  • Flutter version (flutter --version): er staat geen flutter op mijn computer
  • Single or dual screen (if presenter-related): nvt
**Describe the bug** Ik heb de taal in het Nederlands ingesteld, maar de ingebouwde handleiding is in het Engels **Expected behaviour** Ik had verwacht dat de handleiding in de taal zou zijn die de rest van de applicatie gebruikt **Environment** - OciDeck version: 0.2.0 (5) - OS and version: MacOS 26.5.2 - Flutter version (`flutter --version`): er staat geen flutter op mijn computer - Single or dual screen (if presenter-related): nvt
Owner

Fair point: als je een taal ondersteunt dan is het logisch om tenminste de handeleiding in alle talen te hebben.

Fair point: als je een taal ondersteunt dan is het logisch om tenminste de handeleiding in alle talen te hebben.
Owner

Opgepakt (bouwbesluit door de beheerder). Tak: feat/1181-doc-translations. Aanpak: machinevertaal-pijplijn voor de gebundelde gebruikersdocs naar alle talen, met een 'machinevertaald'-melding en PRIVACY/SECURITY_DESIGN uitgesloten (juridische claims). Eerst de mechaniek (variant-resolutie ook voor nl, banner, registratie, make-doel, test), daarna de generatie per taal.

Opgepakt (bouwbesluit door de beheerder). Tak: feat/1181-doc-translations. Aanpak: machinevertaal-pijplijn voor de gebundelde gebruikersdocs naar alle talen, met een 'machinevertaald'-melding en PRIVACY/SECURITY_DESIGN uitgesloten (juridische claims). Eerst de mechaniek (variant-resolutie ook voor nl, banner, registratie, make-doel, test), daarna de generatie per taal.
Owner

Dank voor de melding — terecht punt. De handleiding is Engels omdat dat de brontaal van de documentatie is, terwijl de interface in 32 talen staat; juist Nederlandse lezers kregen niet eens de melding dát het Engels was. Dat is nu recht: elke niet-Engelse lezer ziet de melding, en de app is nu voorbereid om een vertaalde handleiding per taal te tonen zodra die er is. We bouwen een machinevertaling van de gebruikershandleiding naar alle ondersteunde talen (met de Engelse bron als leidend, en privacy-/beveiligingsdocumenten blijven bewust Engels om vertaalfouten in beloftes te voorkomen). Zodra de vertalingen er staan, verschijnt de handleiding vanzelf in jouw taal.

Dank voor de melding — terecht punt. De handleiding is Engels omdat dat de brontaal van de documentatie is, terwijl de interface in 32 talen staat; juist Nederlandse lezers kregen niet eens de melding dát het Engels was. Dat is nu recht: elke niet-Engelse lezer ziet de melding, en de app is nu voorbereid om een vertaalde handleiding per taal te tonen zodra die er is. We bouwen een machinevertaling van de gebruikershandleiding naar alle ondersteunde talen (met de Engelse bron als leidend, en privacy-/beveiligingsdocumenten blijven bewust Engels om vertaalfouten in beloftes te voorkomen). Zodra de vertalingen er staan, verschijnt de handleiding vanzelf in jouw taal.
Owner

Mechaniek gemerged op main (PR #1204): de basistaal is nu expliciet Engels, de melding "alleen in het Engels" toont voortaan voor elke niet-Engelse lezer (Nederlands incl.), en make translate-docs (tool/translate_docs.dart) schrijft docs/NAME.<taal>.md voor de gebundelde gebruikersdocs met een machinevertaal-banner; PRIVACY/SECURITY_DESIGN bewust uitgesloten. Blijft OPEN: het daadwerkelijk genereren van de vertalingen met een gekozen vertaalmotor (>100k regels) is de vervolgstap; zodra die er staan verschijnt de handleiding vanzelf per taal.

Mechaniek gemerged op main (PR #1204): de basistaal is nu expliciet Engels, de melding "alleen in het Engels" toont voortaan voor elke niet-Engelse lezer (Nederlands incl.), en `make translate-docs` (tool/translate_docs.dart) schrijft `docs/NAME.<taal>.md` voor de gebundelde gebruikersdocs met een machinevertaal-banner; PRIVACY/SECURITY_DESIGN bewust uitgesloten. Blijft OPEN: het daadwerkelijk genereren van de vertalingen met een gekozen vertaalmotor (>100k regels) is de vervolgstap; zodra die er staan verschijnt de handleiding vanzelf per taal.
Owner

Genereer nu de Nederlandse vertalingen van de gebundelde gebruikersdocs (besluit beheerder: Nederlands eerst). Tak: feat/1181-nl-docs.

Genereer nu de Nederlandse vertalingen van de gebundelde gebruikersdocs (besluit beheerder: Nederlands eerst). Tak: feat/1181-nl-docs.
Owner

De Nederlandse handleiding staat nu op main (PR #1213, 59f7cb51): alle negen gebundelde gebruikersdocs (USER_GUIDE, FILE_FORMAT, FAQ, TROUBLESHOOTING, ACCESSIBILITY, README, GLOSSARY, SHORTCUTS, KNOWN_LIMITATIONS) in het Nederlands, met een machinevertaal-banner en werkende inhoudsopgaves. Een Nederlandstalige gebruiker krijgt de handleiding voortaan in het Nederlands. PRIVACY en SECURITY_DESIGN blijven bewust Engels. Blijft OPEN: de overige 30 talen volgen als aparte stap met dezelfde aanpak.

De Nederlandse handleiding staat nu op main (PR #1213, 59f7cb51): alle negen gebundelde gebruikersdocs (USER_GUIDE, FILE_FORMAT, FAQ, TROUBLESHOOTING, ACCESSIBILITY, README, GLOSSARY, SHORTCUTS, KNOWN_LIMITATIONS) in het Nederlands, met een machinevertaal-banner en werkende inhoudsopgaves. Een Nederlandstalige gebruiker krijgt de handleiding voortaan in het Nederlands. PRIVACY en SECURITY_DESIGN blijven bewust Engels. Blijft OPEN: de overige 30 talen volgen als aparte stap met dezelfde aanpak.
brenno referenced this issue from a commit 2026-08-04 18:26:32 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
2 participants
Notifications
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#1181
No description provided.